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ABSTRACT 


This thesis project involves the design, 
construction, and implementation of the hardware and 
software necessary to create a low cost assembly language 
debugging utility. The utility is designed specifically for 
the Commodore 64 home computer. 

The hardware consists of a software controlled 
counter which generates a non-maskable interrupt (NMI) after 
a predetermined count. The interrupt occurs once during 
each instruction of the target program. The above mentioned 
process is known as single stepping with a timed interrupt. 

The software consists of a consolidation of commands 
found in high level language debuggers and microprocessor 
development systems. There are also several innovative 
commands such as subroutine suppression and multiple execu¬ 
tion of breakpoints which were developed by the author. 

The above mentioned hardware and software was 
sucessfully implemented. The debugging system has proved 
extremely useful for the author. 
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I. INTRODUCTION 


The microprocessor development system is a 
tremendously important tool to the engineer or designer. As 
part of the development system, the software debugging 
utility is equally important. 

A debugging utility can be defined as a group of 
individual command routines, operating under a centralized 
monitoring program, which allow the user to monitor and 
control the execution of the target code. This monitoring 
program is known as the debug monitor. The various command 
routines should be specifically written for the host 
computer system, thus taking advantage of the computer's 
good points while supplementing the system's deficiencies. 
Examples of these routines are assembly, disassembly, 
memory/register display/modification, monitoring 
memory/registers for a predetermined value, setting 
breakpoints, and single stepping. Although each of the 
above mentioned commands has great importance when 
attempting to debug faulty object code, the most important 
debugging tool would have to be single stepping. 

Single stepping can be implemented using various 
methods. This is dependent on the type of microprocessor 
utilized. Most modern 16-bit microprocessors support single 
stepping using a purely software approach (see Chapter II). 
All of the 8-bit microprocessors studied by the author 
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require an externally generated interrupt which causes a 
control transfer to the single step routine. The interrupt 
can originate from elsewhere in the microcomputer system, or 
from a completely external hardware circuit. 

The host computer system chosen for the debugging 
hardware/software implementation was the Commodore 64. This 
computer utilizes the 6510 microprocessor which belongs to 
the more familiar 6502 family of microprocessors. Since the 
Commodore 64 lacks the necessary hardware to single step 
its CPU, custom hardware has been added (see Chapter IV). 

Previous work on this subject includes thesis 
research by Kamran Khosrani-Kamrani entitled " Toward a Low 
Cost Microprocessor Development System ". Kamrani discusses 
various topics related to the hardware aspect of 
microprocessor development systems. As a host system, he 
also chose the Commodore 64. T.P. Hughs and D.H. Sawin III, 
in their paper " Breakpoint Design for Debugging Software " 
discuss in great detail the interaction of break points 
within a debug monitor program. Eugene Zumchak in 
" Microprocessor Design and Troubleshooting " and R. Bywater 
in " Hardware/Software Design of Digital Systems " both cover 
the hardware and software aspects of microprocessor 
development and debugging. All of the above mentioned 
material as well as others can be found in the Bibliography. 

Based on the previous work as well as other 
contemporary sources, the author has created his own 
customized software debugging system. This system 
incorporates several features of other debuggers, as well as 
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some innovative commands developed by the author. The major 
emphasis is on break point implementation and single 
stepping. 

The thesis manuscript is organized as follows: The 
first section, being this introduction, will attempt to 
introduce the reader to the subject matter and direct him or 
her to specific points of interest in the text. The second 
chapter gives a brief analysis of how the most common 
debugging techniques are implemented. It will also give an 
insight into what commands and/or techniques are important 
in a debugging utility. The third chapter deals with the 
operations of the Commodore 64 microcomputer. It is the 
Commodore 64 which the author has chosen to implement the 
prototype debugger system. The fourth chapter encompasses 
the design of the prototype hardware. The hardware is 
necessary in order to generate a timed non-maskable 
interrupt which initiates the single stepping process. 

Chapter V describes the design and implementation of the 
prototype debugging software. Chapter VI provides a 
conclusion and offers several recommendations to the 
research and prototyped system. 


II. SOFTWARE DEBUGGING 


This chapter's purpose is to provide a tutorial and 
review of software debugging and to provide a philosophical 
foundation for the thesis hardware of Chapter IV and the 
thesis software of Chapter V. 

The analysis of software debugging can be broken 
down into three major divisions. The first is simulation 
and debugging. Although the terms have different meanings, 
they both require the same type of monitoring commands. The 
second section explains how the two most common types of 
debugging commands are implemented on various micro¬ 
processors. The final division contains what the author 
feels is the "ideal" debugging system. 

A. Simulation and Debugging 
Software development is one major aspect in overall 
microprocessor system development. Once the hardware is 
determined to be reasonably correct, the operation of the 
microprocessor system depends on its software. The 
reliability of this software must be tested and ensured. 

The two systematic methods of testing software are 
simulation and debugging. These methods are closely related 
and require further definition. 

Simulation, in the sense of a software development 
system, can be defined as the setting up of conditions for 
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which the system operation is observed. This is 
accomplished by halting execution during key program phases 
and altering the microprocessor registers or computer memory 
locations. The conditions mentioned above can be either 
internal or external in nature. An internal condition is 
one that originates from within the microprocessor system 
such as program flags or stored data. An external condition 
is one that originates from outside the system such as data 
bytes obtained through an I/O port or external bus 
connection. By software simulation, the actual hardware 
connection does not need to be completed in order to examine 
the result. Also segments of programs or subroutines can be 
tested without execution of the calling routines. 

Debugging can be defined as the removal of errors 
within a system. Although debugging connotes the presence 
of a "bug" in the programming, debugging techniques can also 
be used throughout the software development stage to ensure 
the proper operation the the program segments. In addition 
to the removal of outright errors, the debugging process can 
also aid in the optimization of the code. 

Software debugging may or may not involve direct 
evaluation of the operation of the object code. When the 
source program is written in assembly language, debugging 
always involves the object code. When the source program is 
written in a high level language and compiled to machine 
language object code, it may or may not be appropriate to 
examine the object code for debugging purposes. In systems 
programming, especially microprocessor development or 




compiler development, the object code must be examined 
frequently even when it comes from a high level language. 
This thesis is specifically oriented to those applications 
whose nature does require direct examination of the object 
code. 


B. Debugging Techniques 

The two most important aspects of software debugging 
that will be addressed in this paper are single stepping and 
break point design. 

1. Single Stepping 

Single stepping involves suspending program execu¬ 
tion after each instruction, storing the microprocessor 
registers, examining the register and memory contents, and 
then restoring the registers. The single step process 
repeats itself until the loop is terminated by the monitor 
program. The single step routine must be totally trans¬ 
parent to the target program. This means that all micro¬ 
processor flags and register values must be returned to 
their previous value before the next target instruction is 
encountered. 

The most obvious use of single stepping is for 
tracing program execution. For this purpose, after each 
instruction, the register values along with the current 
address and mnemonic representation of the instruction are 
displayed. Single stepping provides the data needed to 
"home in" on a problem. It can determine, for example, 
whether a routine fails because it is fed the wrong data, or 
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because it is structurally defective. Once the defective 
location is found, single stepping through the actual error 
process usually supplies the definitive insight to correct 
the problem. 

There are other uses of single stepping where a 
display is not necessary. Single stepping can be used to 
implement watch commands. A watch command instructs the 
single step routine to monitor a certain register or memory 
location for a predetermined value. This comparison is 
performed after each target program instruction. When the 
predetermined value is detected, the execution of the target 
program is halted. Single stepping through each 
instruction gives the greatest control, but it also 
introduces a large time delay. It is not the only design 
option. W.H. Pierce is currently experimenting with an 
’’Occasional" stepping for debugging purposes, and finds it 
useful 1 . A third use of single stepping is to set break 
points in read only type memory (break points in read/write 
memory are usually implemented by over-writes). This 
application is covered in detail, along with break points, 
in part 2 of this section. Finally, single stepping can be 
used to monitor the target program so that a specific 
operation can be carried out when a particular instruction 
is encountered. A typical application of this would be to 
execute the target program until a jump or branching 
instruction is encountered. 

In general, the transfer of control from the target 
program to the single stepping routine can be implemented 








using two different methods, interrupts or internal micro¬ 
processor flags. The single stepping method is dependent 
upon the type of microprocessor utilized. Table I (page 9) 
summarizes the levels of debugging support implemented by 
various microprocessors. The information contained within 
the table was compiled by the author from Osborne's " 4 & 8 
Bit Microprocessor Handbook " and Osborne's " 16 Bit Micro¬ 
processor Handbook " (see bibliography). As observed in 
Table I, none of the eight bit microprocessors examined by 
the author possessed the ability to single step by internal 
flags. Greater hardware support for debugging appears in 
the 16 bit microprocessors and will be discussed later. 
Single stepping of the eight bit machines must be 
accomplished by means of externally generated interrupts. 

The most reliable interrupt for this purpose is the 
non-maskable interrupt (NMI). The NMI must occur once 
during each target program instruction cycle. By the 
inherent design of the interrupt process, the current target 
program instruction will be executed completely and then 
control will be transferred to the NMI routine. A return 
from interrupt (RTI) will return the microprocessor control 
to the next instruction of the target program. 











TABLE I 

SUMMARY OF MICROPROCESSOR SUPPORT FOR DEBUGGING PURPOSES 


Micro¬ 

processor 

# 

Ext 

Bits 

Manu¬ 

facturer 

SYNC 

Built in 
Single 
stepping 

X-fer on 
Internal 
Error 

Soft¬ 

ware 

Intrpt 

3870/F8 

8 

Fairchild 

no 

no 

no 

no 

8080A 

8 

Intel 

yes 

no 

no 

yes 

8085A 

8 

Intel 

yes(1) 

no 

no 

yes 

Z80 

8 

Zilog 

no 

no 

no 

yes 

6800 

8 

Motorola 

no 

no 

no 

yes 

6502 

8 

MOS 

yes 

no 

no 

yes 

6510 

8 

MOS 

no 

no 

no 

yes 

2650 

8 

Signetics 

no 

no 

no 

no 

TMS9900 

16 

Texas Ins 

yes 

no 

no 

no 

8086 

16 

Intel 

no 

yes(2) 

yes 

yes 

Z8000 

16 

Zilog 

no 

yes(3) 

yes 

yes 

68000 

16(5) 

Motorola 

no 

yes(4) 

yes 

yes 


Notes: 

(1) SYNC signal can be synthesized by the logical 
combination of SO and Si (bus status indicators). 

(2) Single step mode implemented via software, TRAP flag 
internal to microprocessor. 

(3) Single step mode implemented via hardware, STOP 
signal externally input to microprocessor. 

(4) Single step mode implemented via software, TRACE flag 
internal to microprocessor. 


(5) 32 bit internal architecture, 16 externally connected 







































































































Two possible origins of the NMI are illustrated as 

2 

follows. Both circuits were suggested by Eugene Zumchak . 


SYNC 

Gating 

Signal 


Figure 1 - Two Possible Methods of Generating 
Interrupts for Single Stepping 

The first circuit configuration depends on the 
presence of the SYNC signal from the microprocessor. In 
general, the SYNC signal becomes active during each 
instruction fetch, indicating the beginning of the instruc¬ 
tion cycle. The gating signal is software controlled 
through some type of I/O port or additional external hard¬ 
ware. Its purpose is to prevent unwanted interrupts (single 
stepping) during parts of the target program that are to be 
executed normally, and also to prevent interrupts during the 
single stepping routine itself. The logical ANDing (or 
NANDing, depending on the required logic levels) of these 
two signals produce the required NMI. A chip select (CS) 
signal may be required as an additional input to the NAND 
gate on some CPUs. 

The second circuit configuration must be used when a 
SYNC signal is not available on the microprocessor. Without 
a SYNC, there is no external way to determine the beginning 
of a new instruction cycle. In this circuit a presettable 
counter is used. Starting at a predetermined value, the 



NMI 


^2 -1 


Gating 

Signal 


<--- 74LS193 

Presettable counter 


NMI 
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counter circuit counts down the system clock pulses. An 
interrupt is generated when the counter reaches zero. The 
counter is activated via the software several instructions 
before the next target program instruction. The counter's 
initial value must take into consideration the length of the 
delay before the next target program instruction is 
encountered. Figure 2 provides a simplified example of this 
delay. (The example is written using QK-02 addressing 
nomenclature which is presented in Chapter III, section B3). 
This example identifies the worst possible case; a NOP being 
the next target program instruction. The NOP instruction is 
the shortest instruction, only two clock cycles in length 
(for the 65xx family of microprocessors). The interrupt, 
therefore, must occur sometime during the first two clock 


LDA-- $0330 

LDX-- $0331 

LDX# $01 
STX— $DD01 

LDX— $0330 

RTI 


NOP 


Restore accumulator with the 
value before the interrupt. 

Restore Y-register with the value 
before the interrupt. 

Load X-register with $01. 

Send gating signal to I/O port and 
start coutner. 

Restore X-register to the value before 
the interrupt, (counter is counting) 
Dummy return from interrupt used to 
restore the processor status word 
and load the address of the next 
target program instruction from the 
stack. (counter is counting) 

This would be the next instruction in 
the target program. The counter 
will reach zero and generate an 
interrupt during this instruction 
and the single step processing will 
begin. 


Figure 2 - Typical Program Sequence for Counter 
Generated Interrupt. 







cycles of the target instruction - regardless of the 
instruction or its length. Via the NMI, the single step 
data processing takes place. It can be seen that the timing 
for this type of single step scheme is critical. Again, as 
in the first circuit, the gate signal is software controlled 
to prevent unwanted interrupts. 

The 16 bit microprocessors support single stepping 
is a more straightforward way. The Z8000 (Zilog) has a 
dedicated input signal to the microprocessor referred to as 
STOP. When this signal is brought low, the microprocessor 
enters a single step mode. After each instruction is 
executed program control is passed to the single stepping 
routine. This is accomplished through the use of a special 
vector known as the STOP vector. The STOP signal of the 
Z8000 must be software controlled using a gating signal with 
origins similar to the gate signal mentioned for the eight 
bit machines. 

Both the 8086 (Intel) and the 68000 (Motorola) use a 
purely software approach to single stepping. The 8086 has 
an internal microprocessor flag called TRAP. When set, 
program control is transferred to a TRAP routine after one 
instruction is executed. The flag automatically resets 
itself after the instruction is executed. Therefor the TRAP 
flag must be reset at the exit of the single step (TRAP) 
routine. The 68000 utilizes a flag called TRACE. Its 
operation is identical to that of the TRAP flag in the 8086. 
Routines similar to the TRAP and TRACE routines but 
called upon by different vectors, can also be used to allow 
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the microprocessor to recover from fatal errors such as 
divide by zero and attempting to execute invalid or 
undefined opcodes. 

Regardless of the type of microprocessor used 
(either 8 or 16 bit) the target program execution speed is 
greatly reduced during single stepping. This is due to the 
fact that the microprocessor control is diverted to the 
single step routine after each target program instruction is 
executed. The reduction can be as large as 2,000 times 
slower than the normal execution speed. This, of course, is 
dependent on the complexity of the single step routine. If 
a screen display must be provided, the speed reduction is 
not significant since even a larger delay (through a timing 
loop) will be needed to allow the user time to read and 
analyze the screen. If single stepping is being implemented 
to facilitate a watch command or ROM break point (ie. no 
screen display) then the overall execution speed becomes 
a critical issue. A trade off point between the amount of 
data processing in the single step routine and the tolerable 
speed reduction during target program execution must be 
determined. 

2. Break Points 

The second major topic of software debugging is 
setting break points. Break points are used to stop target 
program execution at a predetermined address location. 

During a break routine, the break address and the micro¬ 
processor registers are usually displayed. When a break is 
encountered, all register values must be stored so that 



execution can be continued if the user wishes. 

Break points have several applications. For 
simulation purposes, once the target program is stopped, the 
microprocessor registers and memory locations can be 
altered. When program execution is continued, these new 
values are loaded and used within the target program. By 
setting a break point at the end of a previously debugged 
routine, the code up until that point can be executed at 
full microprocessor speed. After the break point, single 
stepping or other debug monitoring commands can be issued. 
Break points can also be used to examine the results of a 
particular routine after it has been executed. 

In a more advanced debugging technique, a loop may 
fail not on its first or second execution, but on its n-th 
execution. In such cases it is very helpful to activate a 
break point only after n-1 successful executions. 

The setting of a break point can be accomplished in 
two different ways. The simplest approach is to physically 
insert a software interrupt instruction at the desired 
address location in the target program code (over-write). 
Table I (page 9) summarizes the software type interrupts of 
various 8 and 16 bit microprocessors. The software 
interrupt instruction is termed SWI, BRK or RST depending on 
the type of microprocessor system used (for simplicity, the 
instruction will be referred to as "BRK"). When target 
program control reaches the BRK, control is transferred to 
the break handling routine via an interrupt vector. In all 
the microprocessors reviewed by the author, except the 









6510, the BRK instruction is of the non-maskable type. This 
insures that the target program cannot inadvertently mask 
out the break point. 

The above mentioned scenario assumes that the target 
program is located in random access memory (RAM). This is 
usually the case for programs early in the development 
stage. Toward the end of a design project, the software may 
already be committed to read only memory (ROM, PROM, or 
EPROM). If this is the case, a BRK instruction cannot be 
written into the target program code. A second approach is 
to use a microprocessor single step routine. In order to 
implement this type break point, the target program must be 
halted after each instruction and a comparison made between 
the program counter value and the desired break point 
address. If the values are equal, control is transferred to 
the break point handling routine. Otherwise, the next 
instruction of the target program is executed and the 
process repeats itself. 

The first method of setting break points allows full 
speed execution of the target program. It is therefor the 
fastest and the most desirable choice. The second method is 
limited by the execution speed of the single step routine, 
as discussed earlier. 

C, The "Ideal” Debugging Utility 

The "ideal" debugging utility, as envisioned by the 
author, should encompass the following commands and/or 


features: 
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1) Setting of at least two independent break points. 

2) Allowing break points to be encountered up to 2 n -l 
times before breaking execution at it, where n is 
the word length. 

3) Single stepping with one line output on the screen 
for each instruction (tracing). 

4) Controlling the speed of the screen display. 

5) Single stepping without the screen display. 

6) Suppressing the display of subroutines while in 
the tracing mode, (executing an entire subroutine 
in a single step) 

7) Full speed, unmonitored execution of the target 
programs. 

8) Setting watch commands for the microprocessor 
registers as well as individual memory bytes and 
memory words (two byte combinations). 

9) Observe/alter memory at a specific location. 

10) Observe/alter the microprocessor registers upon 

request. 

In addition, it is helpful to have a relocatable 
load command, save memory command and disassembly. 

It is the intent of the author to demonstrate that 
the high level operations, such as those listed above, can 
be implemented on a low cost hobby or home computer. The 
computer selected for this project is the Commodore 64. 
Because the Commodore 64 is considered a hobby computer, 
little emphasis has been placed on the use of this computer 









for the simulation and debugging of assembly language 

* 

programs . Although several debugging monitors exist, 
Micromon, Supermon and Hesmon to name a few, none of these 
possess all the high level commands and features stated 
above. 

In order to implement these commands and features, 
the internal hardware of the Commodore 64 must be analyzed. 
This posses some problems since the computer utilizes 
several proprietary integrated circuits. Fortunately, the 
6510 microprocessor belongs to the 6502 family of micro¬ 
processors, which are well documented. 

Secondly, the Commodore's internal timing and system 
interaction must be examined. The 6510 will be utilized as 
the microprocessor for both the target program and the debug 
monitor program. The timing is critical since the 6510 does 
not possess an external SYNC. The single stepping routine 
will be implemented using timed NMIs. 

The machine language instruction set associated with 
the microprocessor must also be fully understood. This is 
necessary since the target instruction's control over the 
internal 6510 registers and stack must be propagated through 
the interrupt. The interrupt routine cannot be allowed to 
disrupt any of the microprocessor registers if the interrupt 
is to remain transparent. 

Finally, but most importantly, an understanding of 

* 

The earlier Atari computers utilizing the 6502 CPU did 
include the necessary hardware for single stepping. 
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the common programming errors which may occur is warranted. 
Many common errors can be caught during initial assembly of 
the target program. Examples of these are: Mnemonic/extra 
byte mismatch, missing operands, and general typographical 
errors associated with program entry. Other errors such as 
infinite loops, writing over program RAM, improper 
branching, or any unexpected program results require high 
level debugging techniques as mentioned earlier. 









Ill- COMMODORE 64 ARCHITECTURE 

The analysis of the Commodore 64 can be broken down 
into 3 basic sections, the microprocessor, the memory, and 
the I/O devices. The latter two items will be discussed 
immediately, the microprocessor has been reserved for 
section 'B'. 


A- System Configuration 

1- Memory 

The Commodore 64, as its name implies, contains 64k 
bytes of RAM. The memory is formed by a matrix of eight 64k 
x 1 bit dynamic RAMs. In addition to the RAM, there are 
also 20k bytes of ROM memory. This consists of; 8k of 
Basic interpreter, 8k of Kernal (operating system), and 4k 
of character ROM. Since the 6510 microprocessor has only 16 
address lines, it can only directly access 64k of memory at 
any one time. The memory management is performed by a 
programmable logic array (PLA). This device generates the 
required enable signals which switch the various RAM, ROM 
and I/O devices in and out of the memory map. Figure 3 
(page 20) shows the universal and normal (Basic) memory 
maps. The inputs to the PLA, which control the memory map, 
originate from either the microprocessor or the expansion 
port. A summary of the control signals available at the 
expansion port can be found in Table II (page 22). 
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$FFFF - 

$E000 - 
$D000 - 
$C000 - 

$A000 - 

$8000 - 

$4000 - 

$0000 - 


8K Kernal 
ROM or RAM 


8K Kernal 
ROM 

4K I/O or I 

IOM or RAM 

4K I/O 

4K RAM 


4K Useable 

8K Basic 
ROM or RAM 


8K Basic 
ROM 

8K RAM or 
plug in ROP 

I 

$0800 - 

39K 

Useable 

Program 

RAM 

16K RAM 

16K RAM 

System RAM 

_1 


UNIVERSAL NORMAL 


Figure 3 - Commodore 64 Memory Maps 
2. I/O Devices 

The Commodore 64 has several integrated circuits 
dedicated to the input and output of data. Two of these ICs 
have great importance with respect to the system control and 
timing. These are the video interface controller (VIC) and 
the complex interface adapters (CIA). Although they are not 
devices per se, the I/O ports also have great importance to 
the system since they govern how easily the outside world 
can be interfaced to the computer. All three items will be 
discussed following. 

The VIC chip's main function is to control the video 
output. It does this by fetching character values from the 
screen memory matrix and converting them to their dot 
representation via the character ROM. After the output of 


















the VIC chip is buffered, it is directly feed into the rf 
modulator (for television) and to the audio/video port (for 
monitor). 

The character fetches performed by the VIC are 
normally invisible to the microprocessor since it accesses 
the data and address bus during 0 ^ clock cycles only. 

Sharing the control of the address bus with the micro¬ 
processor is accomplished by use of a special control signal 
generated by the VIC chip. This signal, called Address 
Enable Control (AEC), causes the address bus connection 
within the 6510 microprocessor to enter a high impedance 
state. Some VIC operations require the use of the address 
bus longer than one 0 ^ access. The AEC in conjunction with 
the RDY signal allow the VIC chip to force the micro¬ 
processor into a wait state while the VIC performs both 
and 02 ^ us accesses. The system timing will be discussed in 
detail in Part B of this section. 

A secondary function of the VIC chip is to refresh 
the dynamic RAMs. This is performed during video raster 
scans and it is totally transparent to the 6510 micro¬ 
processor system. 

Another important integrated circuit is the complex 
interface adapter. The ClAs (two of them) operate much the 
same as a programmable interface adapter (PIA) and an 
asynchronous communications interface adapter (ACIA). It 
allows the microprocessor to read and write the signals 
required to evaluate the keyboard and control ports. In 
addition, the CIA converts the parallel information on the 











data bus into a serial data format for direct communication 
with peripheral devices. Another feature built into each 
CIA are various timers which can be programmed and read as 
time of day clocks. 

As mentioned earlier, the Commodore 64 has various 
ports for connection of auxiliary and peripheral devices. 
There are dedicated purpose ports such as control ports 1 
and 2 (for joystick or paddle), a cassette port, a serial 
port (for printer or disk drives) and a monitor port. There 
are also two general purpose ports, the user port and 
expansion port. The various signals available on the latter 
two ports are summarized in Table II. 

TABLE II 

SUMMARY OF CONTROL SIGNALS AVAILABLE ON COMMODORE 64 PORTS. 

USER PORT EXPANSION PORT 


ATN —| 

CND1, CNT2 

SP1, SP2 

Connected 

s $ 5 

PC2 

- to CIA 2 

IRQ 

PA2 


R/W 

FL&cf 7 


BA 

DMA 

RESET 

■ to system 

d8t CLOCK 



EX ROM 

GAME 

ROM L, ROM 



i/o 1 , I/0 2 


Connected 
- to micro¬ 
processor 


-- to system 
-- to system 



Connected 
to PLA 


The user port is primarily wired to CIA 2. Through 
this parallel port the connection of a Centronics or RS-232 
interface circuit can be implemented. The user port can 
also used for various speciality control circuits. The 
expansion port is normally used for the connection of ROM 



















cartridges. It can also be used for direct memory 
interfacing applications. The CIA have several of 
functions dedicated to system operation, and cannot be 
totally reasigned new I/O tasks. 


B. 6510 Microprocessor 


The 6510 is an eight bit microprocessor employing 
N-channel MOS circuit technology. With sixteen address 
lines, it is capable of directly addressing a full 64K of 
memory. The principle manufacturer of the chip is MOS 
Technology Inc. It was introduced in June of 1983, when the 
Commodore 64 computer entered the market. To the best of 
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Figure 4 - Block Diagram of the 6510 Microprocessor 
(Reprinted from the C-64 Programmers Reference Guide, 
with corrections by the author) 
























the author's knowledge, this is the only application of the 
microprocessor. Figure 4 (previous page) shows the internal 
configuration of the 6510. 

Other members of the 65xx microprocessor family 
include the better known 6502 microprocessor (used in Atari 
and early 8-bit Apple computers). 

The analysis of the 6510 microprocessor can be 
divided into three parts, a comparison to the more familiar 
6502 microprocessor, the timing and control of the 6510, and 
the software instruction set. 

1. Comparison Between the 6510 and the 6502 microprocessor. 

There are several differences in the hardware of the 
6510 and 6502. These will be discussed in detail in the 
following paragraphs. 

The first major difference between the 6510 and the 
6502 is the origin of the system clocks. Both micro¬ 
processor systems require two non-overlapping clocks, 
referred to in the timing diagrams as 0^ and 0^- In the 
case of the 6502, all that is required is an external 
crystal or clock signal connected to the 0^ input. The 6502 
synthesizes both the J6 1 and clocks from this reference 
frequency. The 6510, on the other hand, requires the 0^ 
clock signal to be input (calling it # oin ). From the J3^ 

* 

reference clock, the 6510 synthesizes the 02 clock output . 

* 

This is contrary to what is found in the C-64 Programmer's 
Reference Guide .^ In it, the writers claim the 0- clock is 
input to the CPU J . Upon studying the schematic diagram of 
the C-64 (Appendix A) the author has determined that there 
is no other possible origin of the signal except the 6510. 












The detailed timing of the 6510 will be discussed in part B 
of this section. 

One addition within the 6510 is the high impedance 
(tri-state) address buffer. The buffer is enabled by the 
AEC signal generated by the VIC chip or by the DMA signal 
which is wired to the expansion port. This feature allows 
direct RAM/ROM accessing without a conflict with the 
microprocessor. 

A third feature of the 6510 not found in the 6502 is 
the built in six bit peripheral data register. Several bits 
of this register control the memory configuration via the 
PLA. Other bits of the register control several special 
purpose I/O tasks. The data direction register for this 
port appears at $0000 and the peripheral data register is at 
$0001 in the memory map. 

Both the 6510 and the 6502 microprocessors are 
contained in the same size package (40 pin DIP). In order 
to accommodate the additional peripheral data lines on the 
6510, two control signals were eliminated from the 6502 
design. These were the set overflow (SO) and SYNC signals. 
The SO was an input to the 6502 microprocessor used to set 
the overflow bit of the processor status word. This was not 
considered, by the author, as a significant loss. The SYNC 
was an output of the 6502 microprocessor used to signal the 
fetch of the next instruction opcode. This signal, on the 
other hand, is extremely important for a single stepping 
scheme. Because of the lack of a SYNC signal on the 6510, a 
hardware counter circuit was necessary in order to implement 











the thesis (see Chapter IV). 

The software instruction set is identical in both 
microprocessors and will be discussed in section 3. 

2. Timing and Control 

As mentioned above, the 6510 microprocessor 
functions with two, non-overlapping clock signals which 
operate between 0 volts and Vcc (+5VDC). The overall 
Commodore 64 system timing originates as a 14.32MHz. signal 
referred to as J0r color - This clock signal is utilized by the 
VIC chip in the video scanning process. Through use of a 
74LS193 counter, the signal is reduced to 8.18MHz., referred 
to as £f dot . This clock signal is also used by the VIC chip. 
The VIC chip internally divides the clock by a factor 

of eight which thus produces the 1.02 MHz. £f Q ^ n required by 
the 6510 microprocessor (known as 0^). As mentioned 
earlier, the 6510 synthesizes the 0 ^ from the 0^. The time 
between each successive 0^ defines a machine cycle. 

There are three basic machines cycles from which all 
the 6510 instruction cycles are derived. They are; read 
cycle - read a byte from the data bus, write cycle - write a 
byte to the data bus, and an internal cycle which does not 
affect the bus states. Figure 5 (next page) shows the 
simplified bus timing for both the read and write cycles. 

The following signals comprise the control of the 
6510; NMI, IRQ, R/W, RDY, RESET, AEC. The operation of the 
first five are identical to that of any other typical 
microprocessor. The AEC as mentioned earlier, isolates the 
microprocessor connection to the address bus. This feature 










Figure 5 - Read and Write Machine Cycle Timing Diagram 


allows other peripheral chips to control the address bus. 

The 6510 microprocessor uses the last six memory 
locations ($FFFA-$FFFF) for the NMI, RESET, and IRQ vectors 
respectively. The hardware interrupt (IRQ) and the BRK 
instruction (software interrupt) share the same vector 
location in memory. It is therefore necessary for the 
interrupt routine to check the microprocessor status flag 
during an interrupt to determine whether it was an IRQ or a 
BRK which had occurred. 

' The 65xx family of microprocessors, especially the 
6510, provide very few external control signals. This tends 
to complicate the design of the microprocessor system, 

4 

according to Osborne . For one thing, the 6510 lacks a VMA 
(Valid Memory Address) signal. It also lacks a DBE (Data 
Bus Enable). The 0^ clock must be used in place of the 
above mentioned signals. Finally, the 6510 does not have an 













interrupt acknowledge output. Without the acknowledge, the 
system does not know when ah interrupt routine is being 
executed. 

3. Software Instruction Set 

The instruction set of the 6510 microprocessor is 
identical to that of any other 65xx microprocessor. The 
instructions themselves, are similar to those of all the 
eight bit machines. The discussion of the software 
instruction set will be limited to the addressing modes 
along with the advantages of the "QK02" addressing 
nomenclature developed and copyrighted by Dr. William H. 
Pierce (used with his permission). The operation of the 
stack will also be discussed. 

Figure 6 shows the programming model associated with 
the 6510 microprocessor. As can be seen there is one 
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Figure 6 - Programming Model of the 6510 Microprocessor 
(Reprinted from the C-64 Programmers Reference Manual) 
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accumulator, two 8-bit index registers, an 8-bit stack 
pointer, and an 8-bit status register utilizing six status 
flags. 

The X and Y index registers, being only eight bits 
in length, cannot absolutely index to any memory location 
(since 64k of memory). Thirteen address modes are provided. 
These addressing modes give the 6510 microprocessor the 
versatility that may have otherwise been lost due to the 
limitations of the index registers. 

Table III (next page) shows the entire instruction 
set of the 6510 microprocessor, it includes the valid 
addressing modes as well as the extra byte requirements and 
execution times (in clock cycles). The QK-02 addressing 
nomenclature was added to the table and will be discussed 
immediately after the addressing modes are explored. 

The thirteen addressing modes, as described in the 
6510 literature are as follows: 


Immediate 


Absolute 


Zero Page 


Accumulator 


The byte following the instruction is 
the data byte. 

The two bytes following the instruction 
contain the address of the data byte. 

The one byte which follows contains the 
low address of the data. The high 
address byte is assumed zero (hence zero 
page, $00hh). 

The accumulator is the object of the 



instruction. 
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Implied 


The register is implied by the 
instruction. 
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zero page by the sum of the X register 
and the data byte which follows. 

Indirect Y (post-indexed) The address is given in 

zero page by the data byte which 
follows. The value of the Y-register is 
then added to this address. 

Zero Page X, Zero Page Y The zero page address is 

given by the byte which follows plus 
either the X or Y register value. 

Absolute X, Absolute Y The address is given by 

the two byte address which follows plus 
the X or Y register value. 

Relative The address is relative to the opcode 

location. It is calculated by using the 
data byte which follows (an 8-bit signed 
2's complement). 

Indirect The two data bytes which follow contain 

the location of the address to which the 
jump will take place. 

Using the conventional nomenclature, the desired 
addressing mode is determined by the number of bytes 
supplied after the operand, or by cumbersome characters 
added to the extra bytes. The QK-02 nomenclature alleviates 
many problems by adding a two character suffix to the end of 
the mnemonic. Table IV (next page) provides several 
examples. 

As seen from the comparison, the addressing mode can 
be easily detected with the QK-02 nomenclature (by observing 
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the one or two character suffix to the mnemonic). This is 
an advantage during a visual inspection of the source code 
listing. It is also beneficial for the implementation of a 
source to object code assembler. By examining the suffix 
(the desired addressing mode), the quantity and value of the 
extra bytes supplied can be checked for correctness. An 
assembler of this type was implemented by the author (in 
Basic programming language), and all prototype programs were 
written using the QK-02 nomenclature. 


TABLE IV 

COMPARISON BETWEEN THE CONVENTIONAL AND THE QK-02 NOMENCLATURE 


Addressing 

Nomenclature 

Mode 

Conventional 

QK-02 

Immediate 

LDY #$3C 

LDY# $ 3C 

Absolute 

LDA $304B 

LDA-- $304B 

Zero Page 

LDX $80 

LDX- $80 

Accumulator 

ROL 

ROL 

Implied 

TAX 

TAX 

Indirect X 

LDA ($1C,X) 

LDAX) $1C 

Indirect Y 

LDA ($1D),Y 

LDY)Y $ID 

Zero Page X 

LDA $15,X 

LDAX $15 

Zero Page Y 

LDA $FF,Y 

LDAY $FF 

Absolute X 

STA $3C74,X 

STAXX $3C74 

Absolute Y 

STA $B47C,Y 

STAYY $B47C 

Relative 

BEQ $C0 

BEQ $C0 

Indirect 

JMP ($F030) 

JMP() $F03 0 


The stack pointer of the 6510 is eight bits in 
length, thus providing a maximum of 256 continuous bytes of 
stack memory. The stack is non-relocatable. Through its 
internal hardware, the stack is permanently mapped into page 
one of memory ($0100 - $01FF). An interesting aspect about 













the stack worth mentioning is that the stack is circular in 
operation. If the stack is incremented past $01FF, it 
recycles to $0100. This is true of the converse also, if it 
is decremented below $0100, it recycles to $01FF. No error 
is generated during this process. This feature is not 
readily useful as a programming tool. In fact, it can be 
detrimental if many stack manipulations are present in the 
target program. 






IV PROTOTYPE HARDWARE 


The purpose of the hardware portion of the project 
is to cause the 6510 microprocessor to single step from 
instruction to instruction. Due to the design of the 
Commodore 64 and the 6510 CPU, single stepping cannot be 
achieved without this external hardware. By the definition 
of the interrupt process; if an interrupt occurs during an 
instruction, the instruction is carried out entirely and the 
microprocessor control is then passed to the interrupt 
routine. The interrupt is therefore the ideal way to 
generate single stepping in the 6510 microprocessor. Since 
the 6510 is not equipped with a SYNC output, the interrupt 
(non-maskable interrupt, NMI) must be of the "timed 
interrupt" type as mentioned in Chapter II. 

The hardware portion can be broken down into two 
major phases, the design and the implementation. This 
chapter will encompass these aspects of the thesis project. 

A. Prototype Hardware Design 
To insure a viable design, the design criteria for 
the interrupt circuit needs to be established. This will be 
discussed in the following section. The circuit operation 
and the hardware/software timing will then be analyzed later 
in this chapter. 
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1. Design Criteria 


In order to create the necessary timing circuit, a 
set of guidelines were developed. These guidelines were 
established early in the prototype hardware design stage. 
The basic design criteria is as follows: 

a) The circuit must count a predetermined number of 
j 02 signals before generating an interrupt. 

b) The predetermined value mentioned in (a) must be user 
selectable (at least during initial implementation). 

c) A pulse from the C-64 via the Pb Q of CIA2 must: 

1) Cause the circuit to load the count value. 

2) Start the counting of pulses. 

d) When the counter reaches zero, a high-to-low-to-high 
level pulse must be generated. The pulse, in turn, 
must: 

1) Generate a NMI within the C-64. 

2) Halt the counting of pulses. 

e) The circuit must latch into its inactive state 
after power up. 

f) The circuit must meet the power and frequency 
requirements of the Commodore 64 computer: 

1) I < 50ma @ 5VDC. 

2) f = 1MHz. 

g) Since the interrupt output will be hardwired into the 
6510's NMI, a disconnecting means must be provided to 
free up the NMI for the keyboard generated NMI. 


A timing circuit was designed and implemented to 





meet the above mentioned criteria. 


2« Circuit Operation 

The basic operation of the circuit is fairly 
straightforward. A pulse from the Commodore 64 causes a 
counter to load a predetermined value. It then starts 
decrementing the value, with each pulse, until zero is 
reached. Upon reaching zero a NMI is generated in the 
Commodore 64. 

Figure 7 shows the functional diagram of the counter 
circuit. All integrated circuits were chosen to be of the 
low power Schottky design in order to minimize the current 
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Figure 7 - Functional Diagram of the NMI Timer 
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drain on the C-64. The counter IC chosen was a 74LS193. 

It was utilized because of its count down capabilities, 
borrow output, and its presetability. The 74LS10 (triple 
three input NAND) has a twofold purpose. First of all it 
generates the count down pulse used by the 74LS193. This 
pulse is synthesized by the logical NANDing of the 6510's 
signal and the gating signal. The AEC input to this NAND 
gate was eliminated during the implementation stage. This 
modification will be discussed in part B of this chapter. 

The second use of the 74LS10 is to comprise a latch which 
generates a gating signal which, in turn, controls the 
counting process. The detailed circuit operation will 
follow. 

The START pulse (Pb Q of the C-64) causes the 74LS193 
to load a preset, 4-bit, binary value. This counter value 
is user selectable through a DIP switch. The START pulse 
also sets a latch which generates the gating signal. With 
the gating signal active (high), the NAND gate will start 
passing the # 2 signal through to its output, inverted of 
course. This signal is then called the DWN pulse which is 
applied to the 74LS193. With each DWN pulse, the counter 
value will be decremented by one. Upon reaching zero, the 
BORROW output of the 74LS193 becomes active (low) which 
clears the latch (halting count DWN pulses), and through a 
hardwired connection, generates a NMI within the Commodore 
64. Since the NMI connection is hardwired, a disconnecting 
switch is provided so that the circuit’s NMI connection can 
be isolated from the computer. It should be noted that the 
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circuit output (NMI) is standard TTL logic rather than open- 
collector. This will be discussed later in this chapter. 

An LED is also provided which indicates the logic of the 
isolation switch. The Commodore 64 RESET signal is 
connected to the latch as an additional clear input. This 
ensures that the latch will be cleared and no counting will 
take place upon power up of the computer. 

Data sheets on all the integrated circuits utilized 
in the timer as well as pertinent ICs in the Commodore 64 
itself can be found in Appendix A. 

3. Timing/Software Interaction 

The details of the software and the associated 
timing of the single stepping circuit will be discussed in 
this section. The overall prototype software design and 
implementation will be presented in chapter V. 

The following scenario gives the sequence of events 
preceding the execution of one target program instruction 
and the NMI which occurs during it. 

a) Push the previous processor status word (PSW) and the 
address of the next target program instruction on the 
stack. 

b) Restore all microprocessor registers, except the X 
register (X-register chosen arbitrarily), to their 
previous value, that is, the value during the last 
target program instruction. 

c) Use the X register to send the output pulse, via the 
CIA, to the timer circuit. The timer will now start 
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counting 0^ pulses. 

d) Restore the X register to its previous value. 

e) Perform a RTI which will reload the PSW and the address 
of the next target instruction from the stack. 

f) The target program instruction will now be executed and 
an NMI will be generated during the instruction. 

As seen from the above scenario, the timer will be 
active (counting pulses) from events c-f. This 
represents the time total delay which must be provided 
before the interrupt can take place. Table V is a 
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TABLE V 

REALIZATION OF DELAY TIME FOR A TIMED NMI 


Instruction 

Purpose # 

cycles 

LDA-- 

$0345 

Get high byte of next inst. 

(a) 

PHA 


Push on stack. 

(a) 

LDA-- 

$0349 

Get low byte of next inst. 

(a) 

PHA 


Push on stack. 

(a) 

LDA-- 

$0343 

Get previous PSW. 

(a) 

PHA 


Push on stack. 

(a) 

LDY-- 

$0340 

Restore previous Y reg. value. 

(a) 

LDA-- 

$0342 

Restore previous Acc. value. 

(a) 

LDX# 

$00 

Set X reg to $00. 

(a) 

STX-- 

$DD01 

Send low pulse to timer circuit 




via the CIA. 

(a) 

INX 


Increment X reg. to $01. 

(a) 

STX— 

$DD01 

Send high pulse to timer circuit 




via the CIA. 

(b) 

LDX-- 

$0341 

Restore previous X reg. value. 

4 

RTI 


Return from interrupt... 

6 

• 

XXX 


Target instruction. 



Total delay (in cycles) 10 


Notes: 

(a) Instruction length is not critical since 
timer has not started. 

(b) Timer will start counting at the end of 
this instruction. 
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realization of the time delay using the actual instruction 
sequence implemented by the author in the prototype system. 

Addresses $0340-$0346 contain the stored register values 
from the last target instruction executed. This is 
explained with the programming memory map in Chapter V 
(Table IX, page 58). 

Table V indicates that a total of 10 0^ cycles 
should pass before an interrupt is generated. This 
theoretical value does not take into consideration any 
propagation delay which may be present in either the CIA (in 
the C-64) or the 74LS193. 

Figure 8 (next page) shows the timing diagram 
associated with the software/hardware. Note that the timing 
diagrams for the 74LS193 and the CIA (6526) have been 
provided in Appendix A. There are several points worth 
mentioning with regard to the timing. First of all, the 
LOAD input to the 74LS193 is asynchronous in nature. Upon 
the falling edge of this input the preset value is loaded. 

Decrementing of the preset counter value is not possible 
until the LOAD input is brought back to its inactive (high) 

]|H| 

state. Secondly, the output of the 74LS193 (timer value) is 
decremented on the rising edge of the count DWN pulse. Once 
enabled, the count DWN pulse is in effect the inverted JS^ 
clock signal. 

The propagation delay through the NAND gate and 
counter is approximately 20-50 nanoseconds. This delay is 
considerably smaller than the 1 microsecond Z^ clock, it can 
therefore be neglected. On the other hand, there is a 
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significant delay incurred when data passes through the CIA 
in the Commodore 64. This is due to the fact that data is 
not valid on the peripheral data register of the CIA until 
the next falling edge of the 0 2 clock. This delay, one 
additional clock cycle, must be included when determining 
the overall counter value. The delay is indicated on figure 
8 . 


B. Prototype Hardware Implementation 

Once the circuit and associated software is 
designed, it must be implemented in a reasonable manner. 

This section will address the physical attributes of the 
hardware as well as an analysis of the final counter value. 
1. Auxiliary Port 

In order to implement the circuit several control 
and timing signals were needed externally to the Commodore 
64. These were the S5^, Pb Q (from CIA2), RESET, NMI, 5v, 

Gnd, and AEC. Referring to Table II (page 22) it can be 
seen that not all of the above mentioned signals are 
available on any one port. Rather than using both the User 
Port and the Expansion Port (and still not being able to 
facilitate a connection to AEC), an auxiliary port was 
installed in the author's Commodore 64. 

The auxiliary port is a 15 pin, miniature type port. 
It is mounted directly to the main printed circuit board of 
the Commodore 64. Due to the design of the Commodore 64 
enclosure, the rear exposure of the computer was easily 
modified to provide access to the port. The internal 
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connections from various points on the PC board to the port 
itself are made with 24 AWG, solid wire. 

2. Circuit Construction 

The timing circuit is mounted on a 2" x 4", single 
sided, printed circuit board. All the discrete components 
are soldered directly to the PC board. The two integrated 
circuits are mounted via IC sockets. Several unused pins of 
the IC sockets have been removed. This allows additional 
room for the placement of the traces on the PC board. 

Since the RESET control was already utilized in the 
prototype circuit, it was later decided to provide a 
momentary contact push-button to cause a reset sequence in 
the computer. This was extremely useful during prototype 
software debugging and implementation. 

Figure 9 shows the circuit board layout. Mounted on 
the circuit board is the matching connector for the 
auxiliary port located on the Commodore 64. 
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The output of the timer circuit (NMI) is not open- 
collector logic as it should be. The normal TTL output was 
provided because, orginally, the output was to be connected 
to a single shot multi-vibrator in the Commodore 64. It was 
later realized that the multi-vibrator would have generated 
a NMI with too long of a duration. This would require a 
software delay loop with the NMI routine, thus slowing down 
the single stepping. The circuit was alreacd prototyped 
when this design change occured. The author realizes that 
connecting standard TTL to a line with multiple open- 
collector output, such as a NMI input to a microprocessor, 
is not a good design practice. The isolation switch (see 
figure 7) allows the disconnection of the NMI when the 
circuit is not in operation. 

3. Counter Value Implementation 

It was originally thought the AEC input to the 6510 
microprocessor was utilized in its timing sequence. Because 
of this it was included as an additional input to the NAND 
gate (along with jB^) which generates the count pulses. 

During the implementation stage it was determined that this 
was an incorrect assumption. The signal is currently 
disconnected on the prototype circuit. 

The Video Interface Chip (VIC) controls the AEC and 
uses it to cause the address buffer within the 6510 to enter 
a high impedance state (see Chapter III). The Bus Available 
(BA) signal from the VIC is connected to the Ready (RDY) 
input on the microprocessor. Using the above mentioned 
scheme, the VIC chip can ’’steal" #2 cycles from the 6510. 
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Since this is the case, it seems that this should disrupt 
the counter value. Experimental results show that the 
counter works properly in all cases. One explanation may be 
that one "stolen" cycle (ie. the instruction currently being 
executed will take one cycle longer to execute) still allows 
the NMI to fall upon the correct target instruction. Not 
enough documentation was available for the 6510 CPU and the 
VIC for the author to draw a concrete conclusion regarding 
this discrepency. 

Although the calculated counter value of ten was 
indeed correct, at the time of the original circuit design 
this value was not known with much confidence. The DIP 
switch was utilized so that the value could easily be 
adjusted if necessary. 

Having the counter value adjustable lead to 
experimentation with regard to other counter value and 
results. Table VI summarizes these results. 


TABLE VI 

SUMMARY OF INTERRUPT TIMER VALUES 


Timer Value 


Result 


0 

1-2 

3-8 


9 

10 

11-14 

15 


Interrupt does not occur. 

Interrupt occurs during RTI 
instruction, stuck in loop. 
Interrupt occurs during proper 
target instruction, but registers 
are not updated. 

Works in all cases. 

Works in all cases. 

Works for some longer instructions 
only. 

NMI misses the target instruction 
completely. 
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The table data helps support the VIC "cycle 
stealing" reasoning mentioned earlier, since both nine and 
10 counts cause a proper interrupt. 






V. PROJECT SOFTWARE 


The software portion of this thesis research 
involves the creation of various command routines and 
support subroutines which together form the debug monitor 
program. Since this thesis was not intended as an exercise 
in assembly language programming, only major points will be 
addressed. These points will include the software design 
criteria, the overall program logic, single stepping logic, 
break point logic, and the general implementation scheme. 

Appendix B contains the complete program listings. 

The organization within the individual source file listings 
is discussed in section B of this chapter. 

Appendix C provides several sample outputs, via 
screen dumps, along with a detailed explanation of what 
command sequence took place. 

A. Prototype Software Design 

As with the hardware, the software begins as a set 
of design criteria. Using this criteria, the general 
program logic is formed. 

1. Design Criteria 

The software design criteria involve definite 
facts, but it also includes several design assumptions. 

These assumptions are made in order to anticipate the user. 

Care was also taken to provide a system which was 

It 
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ergonomically comfortable. 

The basic design criteria is: 

a) Implement the "Ideal" features indicated in 
Chapter II. 

b) Utilize as many Kernal (operating system) 
routines as possible to minimize programming. 

c) Utilize a jump table so that as the routines 
are moved in memory, program changes are 
minimized. The object code will therefore not 
be relocatable except by rewriting the jump 
table. 

d) The final software product will occupy a 
maximum of 4K bytes of RAM memory residing from 
$C000 to $D000. 

e) During single stepping, one line will be output 
to the screen per instruction. 

f) It is assumed that the target program will 
always be in RAM memory anywhere from $2000 to 
$A000. 

g) It is assumed that during single stepping, if a 
screen display is not selected, the target code 
is free of invalid opcodes. 


Most of the above mentioned criteria were followed 
when designing the necessary software. Due to assembler and 
memory limitations, the final programs, as presented in this 
manuscript, do not reside in memory from $C000-D000 (item 
d). Instead they are sparsely located (to allow for 


L 



LAURA KERSEY library 



49 


modifications during the programming stage) in memory from 
$8400-C000. The program segments would collectively fit, 
however, into the 4K range set forth in item (d) if the 
assembler and memory had allowed it. 

2. Program Logic 

The general program logic of the debug monitor is 
shown in figure 10. 



Figure 10 - Flow Chart of Debug Monitor 
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The logic begins by initializing the program parameters. 

This includes configuring the CIA for an output port to pass 
the START pulse to the counter circuit. From here, a loop - 
the debug monitor itself, is entered. All commands are 
issued from within this loop. These debug commands are 
generalized in the box entitled "Perform command function". 
Table VII (page 55) summarizes the commands implemented by 
the author. Upon issuance of the "Exit" command, the 
monitor loop is exited, parameters are reset, and the program 
terminates. 

The logic for single stepping is considerably more 
complex. Discussed here is the portion of the single 
stepping routine which called upon via the NMI vector. The 
segment executed preceding the NMI (register restore and 
generation of the counter start pulse) has been presented in 
Chapter IV with the prototype hardware. Figure 11 (next 
page) shows the flow chart of the single step routine. 

Upon NMI, the microprocessor registers must be 
stored in program memory RAM (see Table IX, page 58). 

Unlike most CPUs, when an interrupt occurs on the 6510, only 
the program counter and processor status word are stored on 
the stack. There is a NMI software routine first called 
upon in the Kernal (operation system ) which subsequently 
pushes the microprocessor's registers onto the stack. The 
author's program copies the contents of the stack to the 
program’s storage registers. After storing the register 
data, one line of display is written to the screen. This 
display consists of the target instruction's address. 
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disassembled object code (in QK-02 nomenclature), operands, 

and the microprocessor registers. The processor status 

word is displayed in binary so that the individual flags can 

be easily discerned. A time delay loop is executed after 

the screen display to allow the user time to analyze the 

screen information. This time delay is user adjustable. If 

a screen display is not selected or if the subroutine 

suppression parameter (executing through an entire 

subroutine as one single step) is active, the display and 

delay portion of the program is bypassed. Next the current 

opcode is checked to see if whether it is the BRK (software 

interrupt) opcode. If so, control is passed to the break 

point routine which will be discussed later. Following 

this, the watch parameter flag is tested. If active, the 

proper watch comparison (such as comparing the X-register 

with some value) is performed. Upon a match, control is 

passed to the debug monitor. Next, if the user has selected 

a screen display, the validity of the next target program 

instruction is checked. This is done to prevent the 6510 

CPU from "locking up" when it attempts to execute a invalid 

* 

or undefined opcode . The opcode validity is checked by 
searching the disassembly table. The search routine is 
relatively slow but negligible when compared to the screen 
display delay. The opcode validity check only occurs when a 
screen display is utilized. This greatly speeds the 

* 

Other CPUs, especially the 16-bit machines, have built in 
error handling vectors to prevent this "lock-up" from 
occurring. 
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execution in the non-screen display modes. Finally, if more 
single stepping is required,' the registers are restored and 
the counter circuit generates another NMI. Otherwise, 
control is passed back to the debug monitor. 

The break point logic is fairly simple. It is 
presented in figure 12. One should keep in mind that the 
operation of the two break points is identical. 


/bwc\ A^le\ 

( interruptV. -/ ^t®? ' 

V. _ 

i i nuer rupiiv. R outlne 

r* 



Store processor 
registers 


/ is \ 
BRK count' 
= 0 ? 


output message 


Replace opcode 


Debug 

monitor 


Single step the 
instruction 


Re-insert the 
break point 


Restore proces 


Figure 12 - Flow Chart of Break Point Logic 
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As seen from the figure, the break routine can be entered 
by two means. First of all, it can be called upon via the 
software interrupt vector when a BRK occurs during full 
speed program execution (not single stepping). Secondly the 
routine can be entered from the single step routine itself. 

During single stepping, the interrupt mask bit is set in the 
microprocessor. Because of this, the software interrupt 
generated by the BRK instruction is masked. Therefore, a 
comparison (is opcode = BRK?) must made in the single 
stepping software routine as mentioned earlier. The 
remainder of the break routine checks if the break point is 
to be recognized or bypassed until the n-th detection of it. 

If it is to be bypassed, this is accomplished by re-writting 
the proper opcode under the break point and single stepping 
the instruction. The break point is then replaced until 
its next execution when the process repeats. Upon the n-th 
detection (BRK count should equal 0) control is passed to 
the debug monitor. 

There is one important note about break points. 

Since the target code is overwritten by the BRK instruction, 
if an exit command is issued, any current break points must 
be reset. This ensures that the target code is left intact 
after the debugger has acted upon it. 

B. Prototype Software Implementation 

Table VII (next page) contains a summary of the 
final commands implemented by the author. The commands are 
shown in their proper syntax. An important differentiation 

% 


wmiAism mn 



55 


TABLE VII 

SUMMARY OF DEBUG' COMMANDS IMPLEMENTED 


General Operational Commands: 


X 

D hhhh 

M hhhh [jjjj] 

F hhhh [jjjj] xx 
G hhhh 

L "name" [jjjj] 

S "name" hhhh jjjj 


Exit and restore system. 

Disassemble 20 instructions in the QK-02 
Addressing Nomenclature. 

Display memory range Shhhh to Sjjjj in both 
hexidecimal and ASCII. 

{space bar} - freeze display 
'Q' - abort command. 

Fill memory range $hhhh to Sjjjj with value 
$xx. 

Jump to location Shhhh and begin execution, 
completely uncontrolled. 

Load file from disk, if Sjjjj is specified, 
the file will be loaded at that address, 
otherwise it is loaded back to the address 
from which it was saved. 

Save memory range Shhhh to Sjjjj on disk. 


Trace/Execute setup commands: 


P 


B1 

hhhh 

B2 

hhhh 

CB 


DR 


SS 


CS 


LX 

hh 

LY 

hh 

LA 

hh 

LP 

hhhh 

WX 

hh 

WY 

hh 

WA 

hh 

WM 

hhhh 

WW 

hhhh 

cw 



Display program paramters (If and where break 
points are set at, if subroutine supression 
is active, if and to what value a watch is 
set at. 

Define break point #1 at Shhhh. 

Define break point #2 at Shhhh. 

Clear either or both break points. 

Display microprocessor registers. 

Set subroutine supression parameter. 

Clear subroutine supression parameter. 

Load X register with the value Shh. 

Load Y 

Load Accumulator " " " " 

Load program counter with Shhhh. 

Watch the X reg for Shh. 

Watch " Y " " " 

Watch " Acc. 

Watch memory address Shhhh for Sjj. 

Watch address word (two consecutive bytes) 
starting at Shhhh for Sjjjj. 

Clear watch parameter. 


Trace/Execute Single Step Commands: 


E hh 
T hh 

EJ 

TJ 


Execute (single step without screen display) 
Shh instructions and halt. 

Trace (single step with screen display) Shh 
instructions and halt. 

Execute until Jump opcode is encountered. 
Trace " " " " " 


EC Execute continously. 

TC Trace 


EB hh 
TB hh 
HS 


Execute until break point is encountered Shh 
times and then break at it. 

Trace until break point is encountered Shh 
times and then break at it. 

Hide Subroutine - execute the remainder of 
the subroutine (single step without screen 
display). 


During all Trace/Execute commands, the following 
keys are scanned: 


{csr up} - increase trace 
(csr dn} - decrease " 

S - Single step to 
Q - Abort command 
{space} - freeze display 


speed (Trace mode only), 
next instruction. 


Notes: 


xx, hh 


hhhh 

[jjjj] 


represents 8-bit hex values, 
represemts 16-bit hex values, 
optional input. 




5s 

Pw 

X 

N* 

3CI 
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should be made between "trace" and "execute" pertaining to 
single stepping. Through the programs, trace indicates 
single stepping through the object code with a screen 
display. Execute, on the other hand, refers to the single 
step execution of the object code without the screen 
display. 

It it beyond the scope of this manuscript to attempt 
to explain the programming of each command sequence. The 


TABLE VIII 

SUMMARY OF PROGRAM SEGMENTS IN SOURCE FILE LISTINGS 


Source File 

Contents 

DRIV.SO 


Program initialization, main debug loop. 

SUB1.S0 

subroutines 

Binary to ASCII hex output, Binary to 

ASCII binary output, clear input 
buffer, read keyboard, error check, set 
system vectors. 

SUB2.S0 

subroutines 

Decode keyboard, add value to zero page 
indexes, compare zero page indexes. 

SUB3.SO 

subroutines 

Output registers. 

CMD1.S0 

commands 

Display memory, Hide subroutine. Fill 
memory. 

CMD2.S0 

commands 

Disassembly, 

CMD3.S0 

commands 

Load memory. Save memory. Display 
registers. Exit, Set break. 

CMD4.SO 

commands 

Clear, show parameters. 

CMD5.S0 

commands 

Go, Load registers. Watch 
registers, Subroutine supression, 
Trace/Execute setup, NMI setup. 

CMD6.S0 

commands 

NMI single step routine. 

MESS.SO 


ASCII messages and reference table. 

BRK1.SO 


BREAK interrupt routine. 

JUMP.TBL 


JUMP table. 


various commands are organized in ASCII files (see Appendix 
B). Several commands and/or subroutines are consolidated in 
each ASCII file. Table VIII provides a summary and 
breakdown of the contents of each file. The analysis of the 
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programming for each command sequence is left up to the 
reader, using the source code of Appendix B. 

The assembler utilized by the author could not 
assemble the approximately 1,000 lines of source code if 
contained in one source file. Therefore, the source code 
has been seperated into program segments, as mentioned 
earlier. By utilizing a jump table, as routines (or program 
segments) were moved or expanded, only the reference in the 
table required changing. This is a great advantage over 
direct calls to routines since, in the later case, all 
references to the altered routine would need to be found and 
modified. The additional jump imposed on each routine call 
offers a negligible execution speed decrease. A jump table 
was also utilized in the Commodore 64's kernal (operation 
system). This allowed easy software interfacing with the 
operation system. 

Table IX (next page) provides a memory map of the 
various memory locations used for registers, flags, and 
counters. It would have been advantageous to utilize zero 
page locations for these program variables (from a program 
size standpoint - zero page addressing requires one less 
operand byte). The majority of zero page is controlled by 
the kernal. The author felt the integrity of this data 
might be in jeopardy since an unforeseen kernal routine 
could disrupt the data. The data is located in the range 
from $033C to $03FF. This area is reserved for cassette 
tape I/O buffering. Since a cassette tape drive is not 
present on the author's system, the data should be safe. 










TABLE IX 

MEMORY MAP OF PROGRAM REGISTERS, FLAGS, AND COUNTERS 
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LOCATION 

DESCRIPTION 

CONTENT/LOGIC 

033C 

ERROR FLAG 

$00=0K, ELSE CONTAINS ERROR #. 

033D 

SUBROUTINE SUPPRESSION FLAG 

$00=OFF 

033E 

WATCH FLAG 

INDICATES IS WATCH IS ACTIVE 
$00=OFF 
$01=WATCH Y 
$02=WATCH X 
$03 = WATCH ACC 
$04=WATCH MEM 
$05=WATCH 2 EYTE WORD 

033F 

WATCH VALUE 

VALUE TO WATCH FOR (EXCEPT WORD) 

0340 

0341 

Y REGISTER 

X REGISTER 

CONTENTS OF REGISTER BEFORE NMI 

0342 

ACCUMULATOR 


0343 

PROCESSOR STATUS REGISTER 


0344 

LOW ADDR. OF CURRENT OPCODE 

“ •« M II , a 

0345 

HIGH ADDR. OF CURRENT OPCODE 


0346 

STACK POINTER 


0347 

LOW ADDR. OF NEXT OPCODE 

" •• II II II 

0348 

HIGH ADDR. OF NEXT OPCODE 


0349 

MEMORY WATCH LOCATION - LOW 

LOW ADDR OF MEMORY WORD WATCH 

034A 

MEMORY WATCH LOCATION - HIGH 

HIGH ADDR OF MEMORY WORD WATCH 

034B 

TRACE/EXECUTE FLAG 

$00=NO DISPLAY (EXECUTE) 

$01=DISPALY (TRACE) 

034C 

LOW ADD OF BRK PT #1 


034D 

. #2 


034E 

HIGH ADD OF BRK PT #1 


034F 

.#2 


0350 

OPCODE UNDER BRK PT #1 


0351 

. #2 


0352 

BREAK COUNTER 

# OF BREAKS BEFORR STOPPING. 

0353 

BREAK POINT OFFSET 

INDICATED WHETHER BRK POINT 
#1 OR #2 HAS BEEN HIT. 

0354 

SCREEN DISPLAY INTERVAL TIMER 

$80. INITIAL VALUE 

0355 

INSTRUCTION COUNTER 

# OF INSTRUCTIONS TO EE 

EXECUTED OR TRACED BEFORE 
STOPPING. 

0356 

TRACE CONTROL FLAG 

CONTAINS 2ND CHAR OF 'TRACE' OR 
EXECUTE CMD 

0357 

SUBROUTINE LEVEL COUNTER 

USED WHEN SUBR SUPP IS ACTIVE TO 
INDICATE THE LEVEL OF SUBR. 

0358 

BREAK JUST HIT FLAG 

INDICATES THAT A BRK PT WAS HIT 

AND THE ORIGINAL OPCODE NEEDS TO 
BE WRITTEN OVER AS '00'. 

0359 

HIDE SUBROUTINE FLAG 

$01= HIDE SUBROUTINE ACTIVE. 

035A 

WATCH LOW 

LOW BYTE OF WORD TO WATCH FOR 

035B 

WATCH HIGH 

HICH BYTE OF WORD TO WATCH FOR 

035C 

NOT USED 

03SD 

BREAK VECTOR LOW 

CONTENTS OF $0316 AT PGM START 

035E 

BREAK VECTOR HIGH 

" $0317 . 

035F 

NMI VECTOR LOW 

M " $0318 . 

0360 

NMI VECTOR HIGH 

" " $0319 . 
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CONCLUSIONS AND RECOMMENDATIONS 

The major conclusion which can be drawn from the 
thesis research is that the various microprocessors 
available have different degrees pertaining to if, and how 
easily, they can be utilized for debugging purposes. The 
operation of single stepping was fully investigated. 

Secondly, once a microprocessor (or for that matter 
an entire computer system) is chosen, the debugging system 
should be customized around the CPU's features. This design 
style will take advantage of the microprocessors high points 
while making up for the machines deficiencies. 

Specific to the Commodore 64, it was concluded that 
the user lacks much information with respect to the 6510 
microprocessor and the Vidio Interface Chip's operation. 

This could be attributed to the fact that the Commodore 64 
contains proprietary integrated circuits whose design is 
owned by Commodore Buisness Machines Inc. 

It was concluded, as expected, that the execution 
speed of the source code was reduced significantly. Table X 
(next page) provides a summary of this information. 

Several recommendations can be made, most of which 
pertain to the hardware. 

First of all, the standard TTL output of the counter 
circuit should be buffered with an open-collector driver 
such as a 74LS07 buffer/driver or a NAND gate utilized with 
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TABLE X 

RELATIVE EXECUTION SPEED 

(BASED ON THE EXECUTION OF 12,288 NOP INSTRUCTIONS) 

Time Increase 

Actual execution time 25.08 MSec. 


Execution mode 

Trace mode (full speed) 

Trace mode (min. speed) 


3.9 Sec. 
878 Sec. 
5342 Sec. 


156x 
34,996x 
213,022x 


open-collector output. This will provide a proper 
connection to the 6510's NMI input. 

Secondly, the author had removed several of the 
unconnected pins of the IC sockets. This eliminated the 
need for wire jumpers on the single-sided circuit board. 

One problem which developed was that the IC themselves would 
loosen in the sockets. It should be recommended that the 
unconnected pin removal not be done on future prototypes. 
Either jumpers can be installed on future prototypes or 
double-sided printed circuit boards can be utilized. 

Since the AEC was not needed in the final design, 
the auxiliary port installed on the Commodore 64 was not 
absolutely necessary. The choice can be left up to the 
reader as to whether he/she should utilize both the 
Expansion and User ports to obtain the necessary signals, or 
modify the computer with the auxiliary port as the author 
did. 

Regarding the software, when the disassembly routine 
was written, a table containing mnemonic and operand data 
was required in memory. The table was specifically designed 
for disassembly. If assembly were required, a different 
table structure would be desirable. A recommendation should 
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1 

be made to modify the disassembly routine to scan a new 
table which could be utilized for both assembly and 
disassembly. This would greatly reduce memory usage when 
assembly is implemented. 

One additional command could be of great use in a 
debugging utility. This is a variation to the watch 
command. Instead of watching a microprocessor register or 
memory location, watch for a specific target program opcode 
value. This would be beneficial when trying to observe 
various system events. The command could be used similar to 
a general break point. 
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TYPES SN54192, SN54193, SN54L192, SN54L193, SN54LS192. SN54LS193 
SN74192, SN74193. SN74L192, SN74L193, SN74LS192. SN74LS193 
SYNCHRONOUS 4-BIT UP/DOWN COUNTERS (DUAL CLOCK WITH CLEAR) 

... BULLETIN NO. OL-S 771 1828. DECEMBER 1972-REVISED AUGUST I 977 


I SN54*. SN54LS'... J OR W PACKAGE 

• Cascading Circuitry Provided Internally SN54L'... j package 

• Synchronous Operation SN74 '- SN74L '- SN74LS ' • • • J or n package 

(TOP VIEW) 

• Individual Preset to Each Flip-Flop ”--- \ 

__ _ A_ _ OUTPUTS A J 

• Fully Independent Clear Input 

TYPES TYPICAL MAXIMUM TYPICAL 

COUNT FREQUENCY POWER DISSIPATION 
•192,'193 32 MHz 325 mW 

'L192, 'L193 7 MHz 43 mW 

'LS192,'LS193 32 MHz 95 mW 

description 

These monolithic circuits are synchronous reversible 

(up/down) counters having a complexity of 55 , *** UT OUTPUTS INPUTS * OUTPUTS j 

equivalent gates. The '192, 'L192, and 'LS192 - : -- 

circuits are BCD counters and the '193. 'L193 and lofl,c: Low input to ,oad sets °A * A - 

'LSI93 are 4-bit binary counters. Synchronous opera- °B " B - Q c " c ■ and Q o " 0 

tion is provided by having all flip-flops clocked -—- 

simultaneously so that the outputs change coinci- 
dently with each other when so instructed by the 
steering logic. This mode of operation eliminates the 

output counting spikes which are normally associated with asynchronous (ripple-clock) counters. 

The outputs of the four master-slave flip-flops are triggered by a low-to-high-levei transition of either count (clock) 
input. The direction of counting is determined by which count input is pulsed while the other count input is high. 

All four counters are fully programmable; that is, each output may be preset to either level by entering the desired data 
at the data inputs while the load input is low. The output will change to agree with the data inputs independently of 
the count pulses. This feature allows the counters to be used as modulo-N dividers by simply modifying the count 
length with the preset inputs. 

A clear input has been provided which forces all outputs to the low level when a high level is applied. The clear function 
is independent of the count and load inputs. The clear, count, and load inputs are buffered to lower the drive require¬ 
ments. This reduces the number of clock drivers, etc., required for long words. 

These counters were designed to be cascaded without the need for external circuitry. Both borrow and carry outputs 
are available to cascade both the up- and down-counting functions. The borrow output produces a pulse equal in width 
to the count-down input when the counter underflows. Similarly, the carry output produces a pulse equal in width to 
the count-up input when an overflow condition exists. The counters can then be easily cascaded by feeding the borrow 
and carry outputs to the count-down and count-up inputs respectively of the succeeding counter. 



logic: Low input to load sets 
Q n - B, Q_ - C. and Q-, 




absolute maximum ratings over operating free-air temperature range (unless otherwise noted) 


Supply voltage, Vcc (see Note 1) 
Input voltage 

Operating free-air temperature range 
Storage temperature range 


SN54' 

SN54L' 

SN54LS' 

SN74' 

SN74L' 

SN74LS' 

UNIT 

7 

8 

7 

7 

8 

7 

V 

5.5 

5.5 

7 

5.5 

5.5 

7 

V 


-55 to 125 

-65 to 150 


Oto 70 
-65 to 150 

"c 

b c 


NOT E 1: Voltage valuai ara with raspect to network ground tarmlnal. 


Texas Instruments 

INCORPORATED 

eomr oppici aox ton • Dallas, Texas 71222 


















TYPES SN54192, SN54193, SN54L192, SN54L193, SN54LS192. SN54LS193, 
SN74192 SN74193, SN74L192, SN74L193, SN74LS192, SN74LS193 
SYNCHRONOUS 4-BIT UP/DOWN COUNTERS (DUAL CLOCK WITH CLEAR) 

functional block diagrams 
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TYPES SN54193, SN54L193. SN54LS193. SN74193, SN74L193, SN74LS193 
SYNCHRONOUS 4-BIT UP/DOWN COUNTERS (DUAL CLOCK WITH CLEAR) 
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'193, 'L193, 'LS193 BINARY COUNTERS 

typical clear, load, and count sequences 

Illustrated below is the following sequence: 

1. Clear outputs to zero. 

2. Load (preset) to binary thirteen. 

3. Count up to fourteen, fifteen, carry, zero, one, and two. 

4. Count down to one, zero, borrow, fifteen, fourteen, and thirteen. 


LOAO 




DA I A <T 


_r 


COUNT 

UP 


COUNT 

DOWN 


outputs <r 


in 

_ I 

Qb __ _ [ 

r 

Q cin 

i 

°° ~zi 
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SEOUENCE 

ILLUSTRATED 


CLEAR PRESET 


15 0 1 

COUNT UP - 


1 0 15 14 

- COUNT DOWN - 


13 


"""■u 

""*mw 


% 


> 

d> 

‘“"i*. 

"%» 

'"mi*,. 

:;;k 

ill! 

jig 


NOTES: A. Clear overrides load, data, and count Inputs. 

B. When counting up, count-down input must be high; whan counting down, count-up input must be high. 
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TYPES SN54192, SN54193, SN74192, SN74193 
SYNCHRONOUS 4-BIT UP/DOWN COUNTERS (DUAL CLOCK WITH CLEAR) 
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recommended operating conditions 



SN54192 

SN 54193 

MIN NOM MAX 

SN74192 

SN74193 

MIN NOM MAX 

UNIT 


4.5 5 5.5 

4.75 5 5.25 

V 


-400 

--100 

uA 


16 

16 

mA 


0 25 

0 25 

MHz 


20 

20 

ns 

Data setup time, t su (see Figure 1) 

20 

20 

ns 

Data hold time, t^ 

0 

0 

ns 

Operating free-air temperature. T/\ 

-55 125 

0 70 

°C 


electrical characteristics over recommended operating free-air temperature range (unless otherwise noted) 


PARAMETER 

TEST CONDITIONS 1 

SN 54192 

SN54193 

SN74192 

SN74193 

UNIT 

MIN TYPl MAX 

MIN TYP* MAX 

Vih Hiqh-level input voltage 


2 

2 

V 

V11 Low-level input voltage 


0.8 

0.8 

V 

V|« Input clamp voltage 

V C C = MIN - l| ■ —12 mA 

-1.5 

-1.5 

V 

Vqh High-level output voltage 

V C C = MIN. v IH-2V. 

V|l “ 0.8 V, l OH = -400wA 

2.4 3.4 

2.4 3.4 

V 

Vql Low-level output voltage 

Vcc-MIN, V,h-2V 

V| L = 0.8V. l 0L =16mA 

0.2 0.4 

0.2 0.4 

V 

h Input current at maximum input voltage 

Vcc-MAX. V| = 5.5 V 

1 

1 

mA 

1 1 l_l High-level input current 

V C C” MAX - V| * 2.4 V 

40 

40 

mA 

In Low-level input current 

VCc-MAX. V| “ 0.4 V 

-1.6 

-1.6 

mA 

Inc; Short-circuit output current § 

Vcc-max 

-20 -65 

-18 -65 

mA 

ICC Supply current 

Vcc’MAX, See Note 2 

65 89 

65 102 

mA 


t For conditions shown as MIN or MAX. us.^tha appropriate value specified under recommended operatmg conditions for the appl.cadle type, 
tAll typical values are at Vcc >5 V, T A >25 C. 

§Not more than one output should be shorted at a time. 

NOTE 2: Ice is measured with all outputs open, clear and load inputs grounded, and all other inputs at 4.5 V. 


switching characteristics, Vcc = 5 V, Ta - 25° C 


PARAMETER ^ 

FROM 

INPUT 

TO 

OUTPUT 

*max 



tPLH 

Count-up 

Carry 

l PHL 

tPLH 

Count-down 

Borrow 

tPHL 

tPLH 

Either Count 

Q 

1PHL 

'PLH 

Load 

Q 

l PHL 

tPHL 

Clear 

Q 


TEST CONDITIONS 


MIN TYP MAX 

UNIT 

25 32 

MHz 

17 26 

ns 

16 24 

16 24 

ns 

16 24 

25 38 

ns 

31 47 

27 40 

ns 

29 40 

22 35 

ns 


C L - 15 pF, 

R L = 400fi, 

See Figures 1 and 2 


If max = maximum clock frequency 
t P |_H = propagation delay time, low-to-high-level output 
tpM |_ — propagation delay time, high-to-low-level output 


"11111% 
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TYPES SN54L192, SN54L193, SN74L192, SIM74L193 

SYNCHRONOUS 4-BIT UP/DOWN COUNTE RS (DUAL CLOCK WITH CLEAR) 

recommended operating conditions 


Supply voltage, Vc c 
High-level output curre nt. I QH 
Low-level output current, l 0 (_ 

Clock freq uency. f C | ock 
Width of any input p ulse. t w 
Data setup time, t su (s ee Figure 1 ) 

Data hol d time, th " ' 

Operating free-air temperature range, T A 


SN54L192 

SN54L193 

SN74L192 

SN74L193 

UNIT 

MIN NOM MAX 

MIN NOM MAX 


4.5 5 5.5 

4 -75 5 5.25 

V 

-100 

2 

0 3 

-200 j 

mA 

--■ 

3.6 

0 3 

mA 

MHz 

200 

200 

ns 

100 

100 

ns 

0 

0 

ns 

-55 125 

0 70 

’C 


^ctncalchar acterls.ic over recommended operating free-air temperature range (unless otherwise noted) 

I —- 


PARAMETER 

V IH High-level input voltag e 
V|L Low-level input voltage 
V|K Input clamp vol tage 

^OH High-level output voltage 

v OL Low-level output voltage 


TEST CONDITIONS* 


SN54L192 

SN54L193 


VCC * MIN. 
V CC = MIN. 



2 

0.7 

2 

l| ■ —12 mA 

V|H “ 2 V. 

'OH “MAX 

-1.5 

2.4 3.3 

2.4 3.2 

V, H = 2V 

IQL = MAX 

0.15 0.3 

0.2 


SN74L192 
SN74L193 
TYPI MAX 


v OL Low-level output voltage V cc - MIN, V !h = 2V ~ ~ T--- 

T-----Yik_-0.7V, lo, = MAX 015 °- 3 0.2 0.4 V 

—-- put curren t at maximum input volt age Vrr » MAX vTTTTv-------- 

-^ igh ' leVel in P ut Current _ ~~ V cc - MAX.' V, - 2 4 V- ^ I ^ 

‘IL Low-level input current 7T- - - 10 10 U A 

OS Short-circui t output current-? V rf = MAX------- H _ -0-18 mA 

>CC Supply current - - -——--- ll _ -15 “3 -15 mA 

---L Vcc -MAX, Se.No.,2 8 ~j 1-ST-7T ~Ta _ 

For conditions shown as MIN or MAX __ 

All typical values are at V cc - 5 V. T A '« 2S°C. r ° Pr ' a ' 8 Va,ue * p,C,f,Bd under recommended operating condition, for the applicable type 

"V™: lhan ° ne ° UtDut sf,ou,d b8 Ported at a time. 

'CC •* measured w.th all outputs ooen cl»*r i„ ,< • 

tout, open, clear and load input, grounded, and all other mput, at 4.5 V. 

switching characteristics, Vcc = 5 V, T A = 25°C 


PARAMETER1 


TO 

OUTPUT 


Count-up 


Countdown 


Either Count 


TEST CONDITIONS 


C L * 50 pF, 
r L " 4 kfi. 

See Figures 1 and 2 


MIN TYP MAX 

UNIT 

3 7 

MHz 

65 130 


65 130 

ns 

65 130 


65 130 

ns 

104 200 


135 240 

ns 

130 240 



105 200 _ 

110 200 ns 


'mas s maximum clock frequency 

*PLH 3 propagation delay time, low-to-high-level output 

tpHL = propagation delay time, high-tp-low-level output 
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I I— E== D F? X 'v* - SO <<< 


; * * * * * :* $ * +. * # :# * If. * 

' * * 

* ” DR IV. SC" * 

‘ * ^ 

} * :k * * * * * :|. * + * * * * 



I0C *** 

CLD 

* .* :$c * :* >: * 

PROGRAM START ft*.*.******:* 


JSR - - 

$E544 

;CLEAR SCREEN 

. 

LDY# 

$39 


' 

LDHH 

2?i'£ 



LDA# 

4-FF FO 

$05 

; SET CiJRSER 


_ 

$C~S7 

* OUTPUT TITLE 1 

• 

LDY# 

$0 E 


■ 

LDX# 

CLC 

$03 


• 

JSR: - - 

$FFFQ 

;3ET CURSER 

. 

LDA# 

$06 



w •-* /*. ■■ 

$CF 97 

;OUTPUT TITLE £ 


-JSR-- 

$CFS£ 

/SET FLAGS/REGISTERS 

2 $30 

C \ * * t: 

x :< + * :f :t: * 

MAIN DEBUG LOOF *****•#*;*: 


FROM THIS LOOP ALL COMMANDS ROUTINES ARE EXECUTED 
SOME ROUTINES REFER TO THIS ROUTINE AS 
THE MAIN CRIVER LOOP. 

CLC 


LDA# 

$00 


C""A — 

$0320 

/CLEAR ERROR FLAG 

LDA# 

$03 

;OUTPUT PROMPT 

J3R-- 

$C F 3 7 

}MESSAGE OUTPUT 

■ J S R — 

tCr 7C 

;CLEAR INPUT BUFFER 

JSR - - 

$CF7F 

/INPUT FROM KEYS 

LDA# 

$0D 


JSR — 

$FFD£ 

/■CARRIAGE RETURN 

LDA — 

$0£OO 


BEG 

* 1 

;CHECK IF NO CMD 

CMP# 

$0 1 


BEQ 

*2 

;GQTG 1 CHAR CMD 

CMP# 

$02 


BEQ 

+ 3 

/•GOTO £ CHAR CMD 

JMP - - 

*9 

/ IJNRECG CMD MESSAGE 

LDA# 

$7E 

;LOU AOD OF 1CH TAB. 

STA- 

$19 


LDA# 

$C3 

/high add of ich tab 

STA- 

$ 1A 



Mr 


Mr 

IT 

it 


a* 

•*. 

I 

I 

ft 

I 

'» 

w 

a* 

f 

» 


i” 

I*- 

•» 
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¥ =r X 

1_EI = DR I V - SO 

< < < 





CONTINUED ) 




JMP-- 

*4 




*3 

LDA# 

$AE 

5 LOW PDD OF ECH TPB. 




STA- 

$19 





LDA# 

$C9 

;HIGH ADD OF 2CH TPB 



m 

STA- 

$1P 




*4 

LDY# 

$00 




*S 

LOP ) Y 

$19 

J1/E CH TABLE VECTOR 




BNE 

*3 

;END OF TABLE ? 



+ 9 

LDP# 

$03 

;•UNRECOG CMD’ MESSAGE 




STn - - 

$033C 

;SET ERROR CODE 



m 

JSR-- 

$CF34 

;ERROR CHECK NORM RTS 



. 

JMP - - 

$CF73 




*•■5 

CMP - - 

$0E3 i 

;ORIGINAL CMD VALUE 




BED. 

*7 

;CMD FOUND i 




I MY 






I NY 





, 

I NY 





. 

JMP - “ 

*e 




±7 

: ny 


;COPY COMMAND VECTOR 



m 

LDP >Y 

$13 

; TO ZERO PAGE 


.. . 


3TP- 

$18 



•••Hinii: 

m 

I NY 




"Hill;: , 
"HI"::, 

. 

LDP ; Y 

$13 



IIIH 


STP - 

$1C 



. . , 


JSR- - 

*3 

/USE JSR TO E NTER 




JMP - - 

$CF73 

/RETURN TO DRIVER 


i 11 ' 

'III 


JMP < > 

$30 IB 

; C.-iD VECTOR 13 NOW 


Hill: | 

n 



; IN 6018/00 1C 


ll|: 


SIS 


Him 

III 


III'' I 

.. 


BRK 
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l . so < < < 


■ *********** 
; * * 
; *"SUB 1.SO " * 
; * * 
; *********** 


C$340G **** * ***** 

MACHINE TO HEX OUTPUT ********** 

• 

PHA 




P.QR 




“OR 


- 

a 

ROR 



a 

ROR 



■ 

AND# 

S3F 



TAX 




LG A XX 

$CFS0 



JSR - - 

$FFD£ 



PL A 




AND** 

$3F 



TAX 




LDAXX 

$CF60 



•JSR — 

$FFG£ 



RTS 



r 

C$3419 ********** 

MACHINE TO BINARY OUTFUT ********** 

r 

LDX# 

$33 


* i 

FHA 




AND# 

$80 


. 

CO 

n 

GJ 

*£ 


. 

LDA# 

$3 1 

; A3CII ‘ 1 ' 

, 

J MR - - 

*3 


*2 

LDA# 

$30 

; ASCII '0' 

*3 

JSR--- 

$FFD£ 



PL A 



. 

RGL 



. 

DEX 



. 

BNE 

* 1 


- 

RTS 



(5*84 

30 ********** 

CLEAR INPUT BUFFER ********** 


LDA# 

$30 

LDX# 

$00 

STAXX 

$0800 

I NX 


CPX# 

$5 A 

BNE 

*4 

RTS 



'mu 

"%ii" 

'I'm 

!«*. 


> 


'll# 


Ifr 

"N 
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R I L-E s 


SLJB 3. - SO < < < 

<CONTINUED) 


;********** ACCEPT INPUT FROM KEYBOARD ROUTINE ********* 


G$S4 

sc 



. 

LDA# 

$02 


. 

STA- 

$1A 


. 

LDA# 

$00 


. 

CTA- 

$19 


*s 

LDY# 

$00 


:r. 1 0 

J 3 R - -• 

$E i 1 8 


. 

CMP 3 

$20 

; LEADING SPACES 


EEC: 

* 18 


. 

CMFtt 

$2C 

; LEADING COMMAS 


EEC 

* 1 o 


, 

JMP --- 

* 17 



JG F. - - 

$E 112 


:4: I. 7 

CMP 4 

$22 

J QUOTED STRING ? 

. 

BEG: 

* 14 


• 

CMP# 

$00 


« 

BEG 

40 


. 

CM Ftt 

$23 

; SPACE DELIMITER 

. 

EEC: 

4 10 



CMP <4 

$2C 

} CCMMA DEL IMI7ER 

. 

BEG 

* 13 


. 

I NY 




ST A > 

i: i 


. 

JMP - - 

-4- w 


f *4 

L. C !• i« 

$30 


* i r 

J33 - - 

$E 1 12 


. 

CMP# 

$22 



PEG 

* 1 £ 


. 

I NX 




3TAXX 

$0£30 


. 

JMP - - 

4 15 


i 2 

STX-- 

$0230 


% 

JMP--- 

* 18 


•i 10 

tya 



« 

LDY# 

$30 



STm )Y 

$13 


► 

LB A - 

$1S 



CLC 

ADC# 

$05 



c *r;i — 

$ 13 



JMP--- 

* 18 


*6 

TYA 

LDY# 

$00 



STA.VY 

RTS 

$19 



********** CK ERROR FLAG/OUTPUT MESSAGE ********** 
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> > > F—" I I e: = SUB 1 . so < < < 

•:CONTINUED > 


©$34B0 



LDA- - 

$033C 

.? GET ERROR FLAG 



BEQ 

*8 

* NO ERROR 



ASL 





TAX 





PL A 





PL A 


; WASTE FIRST RTS 



JMP - -- 

*13 




L DA — 

$033C 




BEG 

c. C- ’ 

*8 




r’ O'— 

TAX 




*13 

LDAXX 

$CC0Q 




STA - 

$30 




I NX 





LDAXX 

$CC03 




3TA- 

$2 1 




LDY# 

$00 


Hill in 

*7 

LD A )Y 

$20 


Hliilt 


BEQ 

*8 


Hill (, J 
Hill 


J3R — 

$FFD2 


||!|i \ | 


I NY 



Hill; . 


JMP - - 

*7 


Illll; , 

till 

*S 

RTS 



■I|| . 





Iir 

* * ** * **** * SET S' 

'STEM FLAGS/REG ISTERS/VECTGRS ********* * 

!(: ! 

r 

®$S4F0 



•in . ! 

In 

• 

LDA# 

$00 


Ml. 

H" ; 

■ 

LDX# 

$35 

; CLEAR WORKSPACE 


*19 

STA XX 

$033B 




CEX 





BNE 

* IS 


''("I, |'j 


LDXtf 

$0 4 



* 1 l 

LDAXX 

$0315 

;SAVE BRK AND NMI VECTORS 



STA XX 

$035C 




DEX 





ENE 

* 1 1 




LOXtt 

$FF 



• 

STX — 

$DD03 

;SET DOR OF CIA 2 


■ 

STX - - 

$OD0 1 



• 



TO THE AUX CIRCUIT. 



LDA# 

$A0 




STA-- 

$0316 

;BREAK LOU BYTE 



LDA# 

$36 




STA - - 

$03 17 

;BREAK HIGH BYTE 



LDA# 

$30 




STA — 

$0313 

;nmi low byte 



LDA# 

$37 
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> > > l=- I 1_ e: S . SLJB 1 - so < < < 

(CONTINUED) 


ST A-- 

*••03 13 

;nmi high byte 

LDAtt 

$7F 


STA- 

$38 

;PROTECT MEMORY-T 

LD A# 

$FF 


STA- 

$37 

;PROTECT MEMORY-T 

LOA# 

$02 


STA-- 

$0350 

;CLEAR BREAK PT CODE 

STn - - 

$0351 


LDAS 

$80 


STA-- 

RTS 

$0354 

;SET DELAY COUNTER 




iii 

'III 
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F=* I I_ El 5 SUBS - so < < < 


* *********** 
; * * 

; # n subs. so H * 
• * * 

; *********** 


;********** ASCII TO HEX CONVERSION ********** 

r 

<5*859e 

I NY 


. 

STY- 

5-14 

;FINAL LOCATION 


. 

LDAXX 

$0200 

;get #cf chars 


. 

CMP# 

$02 

; 2 CHARS 


. 

3E0 

*S 



. 

:mpi 

$"04 

/ 4 CHARS 


. 

BEG 

*8 




LDA# 

$02 

; SYNTAX ERROR 


. 

STA¬ 

$033C 



. 

R'S 




*8 

I NX 

JSR-- - 

*7 

;CONVERT HIGH BYTE 

*« 

♦ 10 

LDY- 

114 

;get HIGH LOCATION 



STAY'r 

$0000 

;STORE HIGH BYTE 


. 

DEC -• 

$14 

;GET LOU LOCATION 

tit;' I] 
ar4i> ij 

. 

inh 


;PT TO LOU CHARS 

if 

. 

JSR - - 

*7 

;CONVERT LOU BYTE 

it 

. 

LDY- 

$ 14 

;GET LOW LOCATION 

il 

. 

3TAYY 

$0000 

;STORE LOU BYTE 

w 

. 

RTS 





LOAfc 

$00 


•III 

• 

J! IP - - 

* 13 



’ ^ 

ChHR riSC I I TO 

HEX INTERNAL VALUE 


* 7 

LDAXX 

$0800 

;FIRST CHARACTER 


. 

JSR - - 

*2 

;CONVERT 


. 

-DA- - 

$033C 

;CHECK FOR ERROR 


. 

Bf !E 

* i 



. 

TYA 


;mgve into acc. 


. 

RCL 




. 

ROL 




. 

RGL 




, 

ROL 




- 

AND# 

$F0 



. 

5TA — 

$0358 

;temp storage 


. 

I NX 




. 

LDAXX 

$0200 

; second CHAR 


. 

JSR - - 

*2 

; CONVERT 


. 

LDA — 

$033C 

; CHECK FOR ERROR 




P) P) 


f__ j 


(CONTINUED> 


BNE * 1 

TYA JMOVE INTO ACC. 

. ORA — $-6352 ; COMBINE VALUES 

*1 RTS 

r 

ASCII CHARACTER SEARCH ROUTINE 


*2 ldyh 

30 0 


*3 CMP'.'Y 

3CFS0 

; CMP WITH HEX TAB 

BEQ 

*4 


I NY 



CPY3 

310 

; TRY ALL VALUES? 

BEQ 

*5 


JMF — 

*3 


*4 RTS 



* 5 LDA*r 

$0 1 

SET ERROR FLAG 

STA - - 

3333C 


RTS 



/ 

: * * * * * * * .f. 

* ADD TO ZP 

INDEX 'A 1 ********** 

INDEX ’A 

1 IS LOCATED 

AT 313/31A 

. r 

2S8S00 



STA -- 

£26 


CLC 



. LEA - 

•313 


■ i"DC * 

3 So 


STr - 

313 


LDA •- 

31.A 


ADCtt 

30 0 


c t A — 

31A 


RTS 




*********** ADD TO ZP INDEX 'S' ********** 
INDEX 'S' IS LOCATED AT TIB/* 1C 


$•£26 13 



STA - 

CLC 

326 


LDA - 

3 IB 


r.DC - 

3SS 


STA- 

31B 


LDA - 

3 1C 


ADC# 

•303 


STA - 

RTS 

3 1 C 


;********** ADD TO ZP INDEX 'C' ********** 
; INDEX 'C IS LOCATED AT 31D/31E 



34 


A 

A 

A 

F I L-E = 

OS3GP8 


. STA- 

$££ 

CLC 


LDA- 

SID 

ADC~ 

£26 

3TA- 

SID 

LDA- 

S1E 

ADCtt 

S0G 

. 3TA - 

S1E 

RTS 


; l- V \Y * * i 

COMPARE ZP INC! 

J NOTE.”' 

. 

• 

IF A<B THEN CARR 

r 

IF A) =B THEN CARR 

GSBESQ 


SEC 


LDA- 

S19 

SEC- 

SIB 

STA- 

S2S 

LCA- 

51A 

SBC • 

SIC 


<CONTINUED) 


OR *- $20 

FTC 

/ **::::***•:*** MI SC SCREEN FORMATTING ROUTINES *****.**** 

r 

. LDA# S26 'OUTPUT A SPACE 

•J3R. — SFFC2 
RTS 


0SSS46 

LCAtt SOD ;OUTPUT A CARRIAGE RETUURN 

JSR-- SFFC2 

RTS 
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> > > f ii— e: = 


SLJB3 - SO < < < 


;*********** 

* * * 

; *"SUBS.SO'# 

; * * 

;*********** 

r 

S$SS53 ********** OUTPUT REGISTERS ********** 



LDA# 

$13 



STA- 

$D3 



LDP - - 

$3342 

;acc VALUE 


JSP-- 

$CF7S 

;ASCI I HEX OUTPUT 


JSR - - 

$CFE5 

; ;sf> 


L Oft- - 

$034 t 

;X REGISTER 


JSR - - 

$CF7S 



JSR •- 

$CFE3 



LDn- - 

$0343 

; Y REGISTER 


JSR - - 

$CF7S 



JSR - - 

$CF65 



LOft - - 

$0346 

;STACK POINTER 


JSR - - 

$CF7S 



JSR - - 

$CF63 



LDA-- 

$0343 

} PROCESSOR STAT WORD 


JSR-- 

$CF73 

;ASCI I BINARY OUTPUT 


JSR - - 

$CF6S 

; <CR> 

% 

RTS 
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*********** 

; * * 

; *"CMD1.SO"* 

; * * 

; ***** *** * ** 

3*9120 ********** DISPLAY MEMORY COMMAND ROUTINE ********** 



LOY# 

SIS 

* PNTR TO FINAL LOC 


LDXtt 

SO 5 

}PNTR WITHIN INBUFF 


T •• -• 

SC F S3 

f COWER7 


JSR 

$Cr U 1 

;ERROR CHECK -NORTS 


LD A ■■ * 

$02 CP 



dne 

*2 



LDft ; r* 

S00 j 

SETS UP FOR 1 LINE 


3Tr.- 

sic ; 

- OF OUTPUT IF THE 


STA- 

sic ; 

- SECOND AD IS NUL 


JMP - " 

*4 


*c 

LDY# 

Sic 

;PNTR TO FINAL LOC 

■ 

LDX# 

$0ft 

; p NTR WITHIN INBU F F 

■ 

JSR-- 

SCF85 

; CO WERT 

■ 

JSR — 

SCFS 1 

;ERROR CHECK-NORTS 

*4 

LOA# 

SOD 



JSR - - 

SFFD2 



LD ft# 

sot 



JSR-- 

SCFA0 


* 1 

J3R-- 

SCFE5 



L3Y# 

S0O 


■ 

LDA- 

Sin 


m 

JSR - - 

SCF76 


• 

LDA- 

SIS 



JSR-- 

SCF76 



LDft# 

S3 ft 



JSR- - 

SFFD2 


*3 

JSR - - 

SCFE5 



LDA > T 

SIS 



JSR- - 

SCF7S 



I N’T* 

SPY# 

SOS 



BNE 

*3 



JSR - - 

SCFB5 



LDY# 

$00 


*6 

LOA 

SIS 



CMP** 

SS0 



BCS 

*7 



CMP** 

S20 



CCS 

*5 


*7 

LDft# 

S2D 


*5 

JSR- 

- SFFD2 
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> 

A 

A 

¥=- I 

i__ e: = c md l - s o < 




CCONTINUED) 


I NY 




CFY# 

£08 


m 

BNE 

*6 


. 

JSR-- 

£CFBS 



LDA# 

£08 



JSR- - 

£CF3D 

;ADD S TO INDEX 'A* 

9 

JSR - - 

£FFE4 

;CHECK IF KEY PRESSED 

. 

CMP# 

£20 

;SPACE 7 


BNE 

* 13 


*3 

JSR-- 

£FFE4 

; START INTO HOLD LOOP 

. 

3EQ 

*8 


4-1 3 

CMP# 

£5 1 

; - Q 1 -QUIT 


EEQ 

* IS 


.4 O 

JSR — 

£CFA8 

;COMPARE 'A' TC 'B' 

. 

BCC 

* 1 


*12 

JSR - - 

RTS 

£C^E3 


7 

3 £3 

1AA *.**■* ****** 

HIDE SUBROUTINE COMMAND ROUTINE ******* 


LDP - 

£25 

;get LAST OPCODE 

. 

CMP# 

£20 

;UHS IT 'JSR* 


BNE 

* 14 

; ERROR MESSAGE 

m 

LDA# 

£0 1 


. 

STA- - 

S0.33D 

; SET SUE SUPPRESS FLAG 


STA - - 

*0357 

; SET SUE LEVEL COUNTER 

. 

STA - - 

S034B 

;SET TRACE MODE 


STA - - 

£0335 

>SET INSTRUCTION COUNTER 

. 

DTP - - 

T033S 

;SET HIDE SUB FLAG 


FLA 


JADJUST STACK 

m 

FLA 



B 

JMF-- 

£CF3S 

;GOTO TRACE DRIVER 

*14 

LDA ft 

SS4 

;ERROR MESSAGE 


STA — 

£0 2 3 C 

/SET ERROR FLAG 

• 

JSR-- 

£CF3 1 

;NO RTS FROM THIS ROUTINE. 

2£ = 

2SZ *i * * ** * * * * 

FILL MEMORY COMMAND ROUTINE ********** 


LDY# 

£13 

1 START LOCATION 


LDX# 

£05 

;BUFFER POINTER 


JSR -- 

£CF85 

;CGNV ASCI I TO HEX 


LDY# 

SIB 

;END LQCAT/OPERAND 

. 

LDX# 

£SA 

/BUFFER POINTER 


JSR - - 

£CF35 

;CONVERT 

. 

JSR - - 

£CF3 1 


. 

LDY# 

£00 



LDA - 

£ 1 C 

;CHECK IF 1 FILL 

. 

3 ME 

* 10 


m 

LDA- 

£ IB 

;SINGLE LOC FILL 

m 

STA)Y SIS 
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> > > F 7 I i_ e=z s cmd X - 

(CONTINUED) 


RTS 

MULTI FILL SECTION 


LOY# 

$10 



LDXt4 

*0F 



JSR - - 

*CF85 



JSR - - 

*CF9 1 

;CHECK FOR ERROR 


LDA# 

*01 



J3R-- 

*CFA0 



LDY# 

*00 



LGA~ 

*1D 



STS > Y 

*19 



L3A# 

*01 



JSR - - 

*CF9D 

;ADD 1 TO INDEX 

•A 

JSR - - 

*CFA6 

;COMPARE 'A' TO 


BCC 

* 1 1 



RTS 





so < < < 









Cl 
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<ZZ MD 



; *********** 
; * * 

f *"CMOS.SO"* 
; * * 

;*** 4 ****** + 


;*.*** QK.-02 DISASSEMBLY COMMAND ROUTINE ********* 
2$32E0 


. 

LDP — 

$0205 

* CHECK IF NO PARAMS 


BEQ 

* 12 



LCY# 

$10 

? PNTR LOCATION 


LDX# 

$05 

;BUFFER LOCATION 


J3R-- 

$CF35 

;CONVERT 


JSR-- 

$CF31 

;ERROR CHECK NO-RTS 

* IS 

J3R-- 

$E544 

;CLEAR SCREEN 


JSR-- 

$CFB8 



LDX# 

$15 

JLINE COUNTER <20) 


STX- 

$ IF 

;HOLDS # OF LINES 

* 1 

LDA# 

$2E 

■ II II 

/ • 


JSR - - 

$FFD2 



LDA- 

$ IE 



JSR - - 

$CF76 



LDA - 

$10 



JSR-- 

*CF76 



LDXtt 

$03 


A 14 

JSR — 

DEX 

$CFB5 



ENE 

* 14 



JSR - - 

$CFAC 

; actual- disasmbl rout 


JSR - - 

$CFB8 



DEC- 

$ IF 



BNE 

* 1 



JSR- ~ 

$CFBS 



RTS 


• K * L 

DISASS 

EMSLY 

SUBROUTINE *** 

2533 

30 

LDP.# 

$D3 

JLO ADD OF OCT TABLE 


STA- 

$ 1B 



LDA# 

$C3 

;HI ADD OF OCT TABLE 


STA- 

$1C 



LDY# 

$00 


. 

STY- 

$20 

;ML MEMONIC FOINTER 

*2 

LDA > Y 

$ IB 


. 

CMP# 

$02 

;ENO OF OPCODE TABLE 


BNE 

*8 


. 

LDX# 

$03 

;SEARCH FOR OPCODE F 







90 

> 

> >- 

¥=- I 

1 __ EC s C MD S - SO 

< < < 





< CONTINUED) 




LD AM 

S2A 

; '• * " 



if Q 

JSR - - 

SFFD2 





SEX 





. 

ENE 

*3 




. 

LDA# 

SO 1 

;INCREMENT INDEX ' C' 




JSR — 

SCFA3 





RTS 





*8 

CMPM 

SFF 

CHECK IF NEW MEMONIC 



. 

BNE 

* 1 1 

; NO - NOT A NEW MEMON 




INC - 

S23 

SET FOR NEXT MEMONIC 




LDA# 

S3 1 





JMP - - 

*4 




M 1 i 

CMP :• Y 

sic - 

; COMP WITH CURRENT 




BEQ 

*3 

; OPCODE MATCH 




LDA# 

SO 2 

; STEP THROUGH OP TABLE 



*4 

JSR - - 

SCFH0 

; ADD ACC TO INDEX ‘B 1 




JMP - - 

:*£ 




*3 

n 

r 

o 





. 

LEA - 

S20 

TRIPLE MEMONIC VALUE 



. 

ADC- 

S20 

■ II 

r 




ADC- 

S20 

% ii 

/ 




TAX 

LDAXX SCB4 1 ;START OF MEMON TABLE-1 

JSR— SFFD2 ;OUTPUT 1ST CHAR OF MEMONIC 

I NX 

LDAXX SCB4 1 

JSR-- SFFD2 ;OUTPUT 2ND CHAR OF MEMONIC 
I NX 

LDAXX SCB4 1 

JSR — SFFD2 ;OUTPUT 3RD CHAR OF MEMONIC 
I NY 

LDA) Y SIB ;GET ADD/MOD VALUE 


STA- 

S1A 

;TEMP STORE IT 

AND# 

SOF 

;MASK BYTE = Q000 1111 

STA- 

CLC 

SIS 

;temp store it 

ADC- 

TAX 

SIS 

;1/2 OF OFST-ADD TABL 

LDAXX 

SCBE9 

;START OF ADO TABLE 

JSR - - 

INX 

SFFD2 

;OUTPUT 1ST CHAR ADDR 

LDAXX 

SCBE3 


JSR - - 

SFFD2 

;OUTPUT 2ND CHAR ADDR 

JSR — 

SCFB5 


LDA - 

S 1 A 


AND# 

S40 

;mask byte = 01000000 

BEQ 

*5 

;NOT RELATIVE BRANCH 

LDA# 

S24 



JSR-- SFFD2 
LDA > Y SID 




s o 
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>- 

> > 

F=“ I 

1_ El s C MD S - s 




XCONTINUED) 


STA- 

$19 



ROL 




BCC 

* 16 



LDA# 

$FE 

;BACKWARD BRANCH 


SBC - 

$19 



STA- 

$19 



SEC 




LDA- 

$ 1D 



SEC- 

$19 



STA - 

$19 



LG A - 

$ 1E 



SBC# 

$00 



JMP-- 

*15 


*16 


$19 

;FORWARD BRAHCH 


INC- 

$19 



LDA- 

$19 



AMD it 

$7F 



ADC- 

$ 1D 



5TA- 

$19 



LDA- 

$ 1E 



ACC# 

$00 


* iv 

J3R — 

$CF7S 



LCA- 

$19 



JSR - - 

$CF76 



LDA# 

$02 



jr ip — 

*13 


*5 

LDA- 

$ 1 A 

;*** NORMAL EXTRA BYTE ROUTE * 


ROR 




RCR 




ROR 




ROR 




A NO# 

$03 

;MASK BYTE = 00000011 


TAY 




STY- 

$1 A 



EEQ 

*7 



LDA# 

$24 

. n $ 


JSR •• - 

$FFD£ 


*8 

LDA ) Y 

$ 1D 

;OUTPUT EXTRA BYTES 


JSR - - 

$CF76 



GEY 




ENE 

*6 


*7 

INC- 

$ 1A 



LDA- 

$ 1A 


*13 

JSR-- 

$CFA3 



RTS 
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; * * * * 4 * * * * * * 
‘ * * 

; * "CMD3 . SO " * 
} * * 

;********** * 


$3030 *** *** * * * * 

LOAD MEMORY COMMAND ROUTINE ********** 

LDA- - 

$0205 

.J RELOCATED LOAD 7 

BEG 

*2 


LDY# 

$13 

;RELG LOAD ROUTINE 

LDX# 

$35 


J3R- - 

TCP 85 

;CONVERT A3CI1-HEX 

JSR- -- 

$CF3 1 

* ERROR CHECK NO RTS 

LDA# 

$00 


STn - 

$28 


JMF-- 

*3 


:£ L.DAH 

$0 1 

i STANDARD LOAD ROUTINE 

STn - 

$26 


■ 3 LDntt 

$0S 

^LOGICAL FILE # 

LDX# 

$03 

;DEV ICE-DISK DRIVE 

LDY- 

$26 

; SECONDAR v' ADDRESS 

JSR-- 

$FFBn 

;S2T FILE SPEC'S 

LDA-- 

$0233 

;LENGTH OF FILENAME 

LDX# 

$3 1 

;ldui ADDR OF FILENAME 

LDY# 

$02 

y HIGH ADDR OF FILENAME 

•JSR -• - 

$FF6D 

;SET FILENAME SPEC'S 

LDX- 

$13 

}LOW ADD PROG START 

LDY- 

$ 1 A 

;HIGH ADDR PROG START 

LDA# 

$03 

;LOAD FLAG 

JSR - - 

$FFD5 

;LGHD ROUTINE 

JMP -- 

* 1 


■ $3 S D 3 * * 4 * * * * * * * 

SAVE MEMORY COMMAND ROUTINE ********** 

LDY# 

$13 

;PNTR TO START ADDR 

LDX# 

$05 

;PNTR IN INPUT BUFFER 

JSR - - 

$CF65 

CONVERT 

. T SR- 

$CF3 1 

;ERROR CHECK-NO RTS 

ldy# 

$13 

;PNTR TO END ADDR 

LDX# 

$0n 

;PNTR IN INPUT BUFFER 

JSR - - 

$CF35 

} CONVERT 

J 3 R — 

$CF3 1 

;ERROR CHECK-NO RTS 

LDn# 

$0 i 


u 

(.0 

i 

i 

$CFn0 

y INCREMENT INDEX 'B* 

LD A# 

:$01 

; LOGICAL FILE # 

LDX# 

$03 

;DEV ICE-DISK DRIVE 

LDY# 

$00 

;SECONDARY ADDRESS 

JSR - - 

$FFBA 

y SET FILE SPEC "3 
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> 

> > 

I 

1 _ El = C MD 3 - SO < < < 




(CONTINUED) 


LCA-- 

$0230 

' ‘fill 

;LENGTH OF FILE NAME 


LDX# 

$31 

‘ LOUJ ADOR OF FILENAME 


LDYtt 

$3E 

;HIGH ADDR OF FILENAME 


JSR-- 

$FFBD 

;SET FILE NAME 


LDAt* 

$13 

;ADDR CF START 


LDX- 

$1B 

LOUJ END ADDR + 1 


LDY-- 

$ 1C 

;HIGH END ADDRi-l 

r 

JSR - - 

$FFDS 

$15/$1C HAS START ADD 

/SAVE ROUTINE 

* 1 

JSR-- 

$2F3S 

;OUTPUT <CR > 


LCA# 

$03 



— 

RTS 

$0F97 

/OUTPUT 'OK* 

C $3 

4 1C * * f 

***** DISPLAY REGISTER COMMAND ROUTINE ********* 


LDr'i-- 

$0202 

;GET END CMD LETTER 


CMF # 

$52 

; 1 R ■ 


BED 

*4 



LDA# 

$03 



STA- - 

$03 SC 

;SET ERROR # 


JSR - - 

$CF9 i 

;ERROR CHECK NO-RTS 

*4 

LDA4 

$12 

;SPACE OVER 


STA- 

$D2 

;COLUMN STORAGE 


LDA# 

$0B 

/ME3S tt 


JSR-- 

$CF3? 

/MESSAGE OUTPUT 


LCA# 

$13 

; MESS fc 


JSR - - 

$CF97 

;OUTPUT PC VALUE 


LDA-- 

$0243 



JSR-- 

$CF 7 S 



LD A - 

$0244 



JSR - - 

$CF7S 



*f T • - 

$CF8E 

/C 1SFLAY REG ROUTINE 


RTS 




443 ********** 

EXIT COMMAND ROUTINE ********* 


LOX# 

$S4 


*5 

LDAXX 

$035C 

/•GET ERK 3* N! II VECTOR 


STAXX 

$03 15 



□ EX 




BME 

*5 



JSR - - 

$CF9A 

CLEAR ANY BREAKPOINTS 


PLF. 




PLA 



/ 

RTS 


;RETURN TO SYSTEM 

* 

JMP — 

$FE43 

; BASIC WARM START VECTOR 


£$9460 ********** SET BREAK POINT COMMAND ********** 

/ 


II 



94 


!=• I I_ e: = C3 mo 3 . so < < < 

(CONTINUED) 


LDA- - 

$0202 

;GET 2ND CHARACTER 

SEC 



SBCtt 

$31 

■ ADJUST VALUE 

STA¬ 

$2G 

;TEMP STORAGE 

GED 

*6 


CMPH 

$0 1 


E!EQ 

if £ 


LDA# 

$03 

;'UNRECOG CMD' MESSAGE 

STA-- 

$033C 

;SET ERROR FLAG 

JSR -- 

$CFS 1 

;ERROR CHECK NO RTS 

LDY- 

$2S 


LEA'."'. 

$0250- 

i CHECK IF ALREADY SET 

cr rti 

$G2 

> CODE FOR NOT SET 

TEC 

V • 


LEAH 

$04 

.? 'CANNOT EXECUTE ' MESSAGE 

jmp - - 

*3 


LDYH 

$19 


LCK# 

$05 


JSR-- 

$CF 35 

;CONVERT 

JSR-- 

$CF9 1 

;ERROR CHECK NO RTS 

LDY- 

$26 


LOY# 

$00 


LDAX) 

$19 


STftYY 

$0350 

;STORE VALUE UNDER EREAK 

LDA# 

$00 


STAX) 

$19 

/INSERT ACTUAL '00' 

LDA- 

$19 


STAYY 

$034C 

;STORE LOW BYTE 

LDA - 

$ 1A 


STAYY 

$034E 

;STORE HIGH BYTE 

LDA# 

$09 

;'0K' MESSAGE 

J3R — 

$CF97 



RTS 




i a_ 




O 


* * * :* * * * *: * * 
* * 

; * "CM04 . SO " * 
* * 

; **:+:*** * * * * * 


2534BG * * * * * * * * * * CLEAR ... COMMAND ROUTINES 

; - CLEAR SUBROUTINE SUPPRESSION 

T - CLEAR WATCH PARAMETER 

; - CLEAR BREAK POINTS 


. 

LDA-- - 

56£ □£ 

;GET 2ND CHARACTER 

. 

St :P4t 

$42 

; 1 B• FOR CLEAR BREAK 


5*'IE 

*4 



■ 7 **■■* 

SUER EN 

TRY FOINT 

. 

LC Xtt 

50C 



LDAXX 

50 3 S3 0 

;get stored value 

. 

BED 

*13 

;PASS IF BRK EXISTS 

. 

CMPM 

50 £ 

;CHECK IF NOT SET 

. 

EEQ 

*3 


. 

LDAXX 

5034C 

;get low byte 


STA- 

5 IS 


, 

LDAXX 

5634 E 

.! G E T HIGH EYTE 

. 

STA - 

51A 


. 

LDAXX 

56350 

.t GET OPCODE 

. 

LOY# 

500 


. 

STA > V 

513 

iREPLACE OPCODE 

: s 

LG A# 

50£ 


■ 3 

STA XX 

I NX 

50350 

;CLEAR CODE 

. 

CPX# 

50 £ 

5 CHECK IF DONE 

. 

BNE 

*£ 


• 

JMP-- 

*6 


; 

*4 

CMPtt 

553 

; 1 S ' FOR CLEAR SUBROUT 

. 

BNE 

*5 



LDAM 

560 



STA — 

50330 

;CLEAR FLAG 

■ 

JMP — 

■f S 


r 

*5 

CMP 14 

557 

J'W' FOR CLEAR WATCH 

. 

BNE 

*£0 


. 

LDAtt 

500 


. 

STA - - 

5033E 

;WATCH FLAG 

*6 

LDAM 

509 

> 'OK 1 MESSAGE 

• 

J3R-- 

RTS 

5CF37 


*20 

CMPM 

55 £ 

}• R' - CLEAR REGISTERS 


BNE 

*7 



* * * * * * * * * * 


SUPPRESSION 


CLEAR REGISTERS 


96 


> > 

F=" I 

1 __ e: 

= CC MD -DI¬ 




SCONTINUED) 

LDA# 

$30 



STA - - 

$0340 

CLEAR 

Y REGISTER 

STA — 

$0341 

;CLEAR 

X REGISTER 

STA — 

$0342 

}CLEAR 

ACCUMULATOR 

9EQ 

*6 



LDfitt 

$03 

; ’ UNRECOG CMD 1 MESSAGE 

JSR-- 

$CFS7 



RTS 





^$3515 ********** PARAMETER COMMAND ROUTINE ********* 



ld::h 

$00 


• • •• \ 

$26 

‘3 

LC A 

$3C 


JSR - - 

$CF97 


LDA- 

$26 


CLC 



ADC# 

$3 1 


JSR - - 

$FFD£ 


LDX - 

$26 


LDAXX 

$*3250 


CMP# 

$02 


BNE 

* 10 


LDA# 

$10 


JSR-- 

$CF97 


JMP-- 

*S 

* 1C 

LOfi# 

$1 1 


JSR - - 

$CF97 


L.D X- 

$26 


L 3 A XX 

$034E 


JSR-- 

$CF76 


LDX - 

$26 


LDAXX 

$034C 


JSR - - 

$CF76 


JSR - - 

$CFB3 

*3 

INC- 

$26 


LDA - 

$26 


CMP 4 

$32 


BNE 

*3 


-DA 4 

$3D 


JSR - - 

$CF97 


LD A — — 

$033D 


BE3 

*11 


LDA# 

$0F 


G i JL 

* 12 

* 1 1 

LDA# 

$10 

*: 2 

JSR — 

$CF97 


LDA# 

$0E 


JSR — 

$CF97 


;MESSAGE # 


; DISPLAY L1ATCH VALUE 





W f-J 


97 



w=- i 


C MD - SO 

<CONTINUED) 


. 

LDrV* - 

*033E 



• 

BNE 

* 13 



• 

LDA# 

*10 




JSR — 

*CFS7 



. 

RTS 




4: 13 

CMP# 

*0 1 




ENE 

+ 14 



, 

LC A# 

*53 



. 

BNE 

+ 17 



*14 

CMP it 

*02 




ore 

* 15 



• 

LDA# 

*53 



. 

ONE 

+ 17 



:! 15 

CMP it 

*03 



« 

BNE 

+ 18 



, 

LOA# 

*4 1 



. 

BNE 

*17 



*16 

LDA# 

*24 



. 

JSR - - 

*FFD2 



• 

LDA-- 

*034 A 




JSR — 

*CF78 



. 

LDA -- 

*0343 




JSR-- 

*CF76 



. 

JMP-- 

* 18 



* 17 

JSR-- 

SFFD2 



*13 

LDA# 

*12 



. 

JSR - - 

*CF37 



, 

LDA-- 

*033E 

;get 

HATCH FLAG 


CMP# 

*05 

;see 

IF HATCH WORD 

. 

bne 

*21 



• 

LDA# 

*24 




JSR - - 

*FFD £ 

;OUTPUT * ! 

. 

LDA - -• 

*035B 



. 

JSR - - 

*CF76 



. 

LDA- - 

*335A 



. 

JMP- - 

*22 



*2 1 

LDA - - 

*033F 

;get 

WATCH VALUE 

*22 

JSR - - 

*CF76 



• 

JSR-- 

RTS 

*CFB3 











1 


'I 
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x i__ 


/*********** 
/ * * 

; *"CMD5.SO"* 
/ * * 

;*********** 


C r- 1 D 5 _ s o c < < 


S$95E3 ********** GO COMMAND ROUTINE ********** 


, 

LDY# 

$13 

/PNTR TO FINAL LOCATION 


LQX# 

$33 

’PNTR TO ORIGIN 


JSR -- 

$CF35 

;CONVERT ASCII 


JSR - - 

PLA 

PLA 

$I r 3: 

/ERROR CHECK - NO RTS 


LEY •- 

$0 340 

/LOAD Y REGISTER 


L 0 ' - 

$034 1 

;L0AD X REGISTER 


LDA-- 

$3342 

/ LOAD ACCUMULATOR 


JMF < ) 

$30 13 

/TARGET 

£$9332 ****** * * * 

LOAD/WATCH COMMAND ROUT 


LOAN 

$0 1 

;WATCH CMD ENTRY POINT 

„ 

STA - 

$24 

/TEMP FLAG 

ONE 

e$3eoG 

* 1G 

ALWAYS BRANCH 


LDAtt 

$30 



STA-- 

$34 


*13 

LDY# 

$13 



LDX# 

$05 



JSR - • 

$CF85 

/CONVERT ASCII 


JSR - - 

$CF3 1 

;ERROR CHECK - NO RTS 


LGAH 

$33 



STA- 

$25 

/TEMP POINTER 


LOA — 

$0202 

/•GET END CHARACTER 


CMPM 

$53 

JY-REG WATCH OR LOAD 


EEQ 

*3 



CMP# 

$33 

JX-REG WATCH OR LOAD 


BEQ 

*2 



CMP# 

$4 1 

/ACC WATCH OR LOAD 


BEQ 

* 1 



CMP# 

$50 

/LOAD PROGRAM COUNTER 


BEQ 

*4 



CMP# 

$4D 

/WATCH MEMORY LOCATION 


BEQ 

*7 



CMP# 

$57 

/ * w ■ 


BEQ 

*7 


*e 

LDA# 

$03 

/UNRECOG CMD MESSAGE 

• 

STA-- 

$033C 


m 

JSR-- 

$CF3 1 

/ERROR CHECK - MO RTS 


r=~ x 


C MD 

<CONTINUED) 


O 


* 1 

INC- 

525 


*2 

INC - 

525 


4:3 

INC - 

525 


. 

LDA- 

524 

r DETERMINE IF WATCH OR LOAD 


BNE 

*5 

/GOTO WATCH Y X ACC SECTION 

. 

LDA- 

519 

;load Y K ACC SECTION 

. 

LDX - 

525 



STA XX 

503 3F 


*3 

LDA# 

503 

i OUTPUT 'OK' MESSAGE 

• 

JSR — 

5CFS7 


> 0, 


524 

;CHECK IF LOAD ONLY 

. 

2 pit. 

*6 

;GOTO UNRECOG CMD MESSAGE 

. 

LD A - 

519 

JLCAu PROGRAM COUNTER SECTION 

. 

3TA -** 

56344 

;lqw BYTE 

. 

LDA - 

51A 


. 

STA — 

50 343 

,*HIGH BYTE 

. 

JMF - - 

A 9 


*5 

LDn- 

525 

;WATCH Y X ACC SECTION 

1 i 

STA — 

5033E 

;SET WATCH FLAG 

♦ 2 

LDA - 

513 


. 

3 T n — 

5033F 

i STORE VALUE TO WATCH FOR 

. 

JMP - - 

*3 


*7 

LDA- 

524 

;CHECK IF WATCH ONLY 

. 

BEQ 

*6 

JGOTC UNRECOG CMD MESSAGE 

. 

LDA - 

513 


. 

STA — 

50349 

.JLOW BYTE OF MEMORY LOCATION 

. 

LDA- 

51A 


. 

STA - - 

5034A 

/•HIGH BYTE OF MEMORY LOCATION 

. 

LDY# 

519 


. 

LDX# 

50 A 


. 

JSR — 

5CF85 

;CONVERT ASCII 


JSR - - 

5CF9 1 

* ERROR CHECK - NO RTS 

. 

LDA — 

50202 

GET 2ND CHAR AGAIN 

. 

CMP# 

557 

; U ' 

. 

BED 

* 15 



LDA# 

504 

* WATCH MEM FLAG 

. 

3 ME 

*1 1 


k 15 

LDn- 

519 



STA- - 

5035A 

;SET WORD WATCH LOW BYTE 

. 

LDA- 

5 In 


. 

STA - - 

5025B 

* SET WORD WATCH HIGH BYTE 

. 

LDA# 

505 


• 

ONE 

* i 1 

;GOTO SET WATCH FLAG 


S5SSAA ******** SET SUBROUTINE SUPPRESSION COMMAND ******** 


LDP.# 50 1 

STA-- $0330 ;SET FLAG 
ONE *9 



f=- I I_ 


C 1^10 ! 

<CONTINUED) 


O 


$$9652 ********* TRACE/EXECUTE SINGLE STEP ROUTINE ******* 

.? THIS ROUTINE SETS UP THE PARAMETERS FOR 

; THE SINGLE STEPPING ROUTINES. SOME ROUTINES 

; REFER TO THIS ROUTINE AS THE TRACE DRIVER. 

LDA# $01 ;TRACE ENTRY POINT 

JMP- - * 1£ 

CT3SS3 


• 

LDA# 

SOS 

;NO TRACE ENTRY POINT 

MS 

STA *• - 

$034 £ 

; SET/CLEAR DISPLAY FLAG 


LDX • - 

$0202 

I GET 210 CHARACTER - IF PRESENT 


S TX — 

$3353 

/STORE IN TRACE CONTROL REGISTER 

. 

cpx# 

$4 2 

/-CHECK FOR "BREAK" VARIATION 

* 

S.; :E 

:* ID 



LDX# 

$02 


' 14 

LDrXX 

$034 F 

;get break flag 


C'-'Fn 

$02 

i SEE IF SET 

• 

SNE 

OCX 

* 12 



END 

*14 

;CHECK NEXT BREAKPOINT 


LCA# 

$0C 

;OUTPUT PART OF MSG 


J3R - - 

$CF37 


, 

DEC - 

$C3 

' BACKSPACE ON SCREEN 


LDA# 

$10 

;OUTPUT PART OF MSG 

■ 

J3R-- 

RTS 

$CF37 


* 1 3 

LDY-- 

$0235 

;CHECK IF NO COUNT SPECIFIED 


sne 

I MY 

*13 



JMP - - 

* 13 


i- l 

LDY# 

$ 13 

* GET VALUE FROM KEYS 

. 

LDX# 

$05 


, 

JSR-- 

$CF25 



J3R-- 

$CF h 1 


, 

LDY- 

$13 


i 9 

r TY- - 

$0353 

;SET INSTRUCTION COUNTER 

• 

STY - - 

$3352 

;SET BREAK COUNTER 

. 

LDA# 

$00 


• 

STA - - 

$0337 

’RESET SUBR LEVEL 


STA - - 

$0353 

>RESET BRK FT OFFSET 

• 

PLA 

PLA 


} ADJUST STACK DUE TO JSR 

. 

LDA - - 

$0345 


1 

BEQ 

*20 


. 

LDA# 

$0 A 


• 

JSR — 

$CF37 



LDA# 

$12 





01 


CZ: MO 5 _ SO < < < 
XCONTINUED) 


STA- $03 
LDA# $0B 
JSR-- SCF97 

PREFAIR FOR NMI GENERATION ... 


3EI 


;BLOCK KEY SCANS 

LDA — 

PHA 

$3345 

;get 

HIGH BYTE OF INST 

LDA - - 

PHA 

$0344 

;get 

LOU BYTE OF INST 

LDA-- 

r’HA 

$0343 

J GET 

PS LI 

LOY • - 

$•3340 

GET 

Y REGISTER 

LDP-- 

LDXH 

$0342 

$33 

/ GET 

ACCUMULATOR 

3TX - •• 

*sw 

$cos: 

* START AUX COUNTER CIRCUIT 

Z‘ I .*> 

$DC0 1 

;end 

OF FULSE TO AUX CIRCUIT 

LDP, - - 

$034 i 

;get 

X REGISTER 

RTI 


* P ICK 

UP AT PROPER POINT 


IN THE TARGET PROGRAM 



41 iJ 
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f=^ i j_ e: = c r^-io e . so < < < 


; r: r. *■ t. ** * * * a * 
; * * 

;*”CMDG.SC " * 
; * * 

; t * * * * ;(c :* * 4 J* * 


jn * s * if. n. * * * * * mm i ' 
THIS ROU" r Il'JE IS 
VECTOR. 


INGLE STEPF ING 
CALLED UPON VIA 


ROUTINE 


THE NMI 


* * * * * * * * * * 


*31 


c T' ,# — 

$0340 

STX-- 

$0:4 i 

STA - - 

$53343 

PL A 

ST; - - 

$C243 

PL A 

STA- - 

$0347 

^LA 

STA - - 

$0343 

TSX 

STM - - 

$0346 

CL I 

LDA-- 

$S3 44 

STA- 

$ 1D 

LDA- - 

$0345 

STA- 

$! E 

LDY^' 

$00 

LDA > Y 

$10 

STA- 

$25 

BNE 

*31 

JMF - - 

$CF3E 

LDA - •• 

$0357 

3NE 

*33 

DEC — 

$0355 

LDA - - 

$0345 

BED 

*33 

LDX ••• 

$6354 

LDYtt 


DEV 

CNE 

*14 

DE.X 

3NE 

*13 

TNC- 

$D3 

LDA - 

$ 1E 

JBE-- 

$CF7S 

LDA - 

$ ID 

JSR-- 

$CF7S 

INC- 

$□3 

JSR — 

$CFAC 


;STORE Y REGISTER 
;STOP.E X REGISTER 
* STORE ACC 
i GET PSl-J 
•STORE FSW 

,‘GET LOW BYTE OF NEXT INST 
}STORE 

; GET HIGH BYTE CF NEXT INST 
JSTORE 

;MOVE STACK POINTER 
;STORE STACK POINTER 

,‘GET CURRENT OFCODE LOCATION 


.! GET CURRENT OPCODE 
.{ TEMP STORE OPCODE 

;GG TO BRK ENTRY POINT IN BRK ROUTINE 
;CHECK SUER LEVEL COUNTER 

/ OECRE HE NT I NS TR U C T10 N C 0 U NTE R 
;CHECK CISPLAY/ NODISPLAY FLAG 

;START SCREEN DELAY TIMER 
;DELAY IS APPROX <$0354>*0.03 13 


/•THIS SECTION OUTPUTS ONE 
; LINE OF SCREEN DISPLAY. 

;OUTPUT HIGH MEMORY BYTE 

;OUTPUT LOW MEMORY EYTE 

;OUTPUT DISASSEMBLED MEMONIC 
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>- >- > F=~ X I__ f£Z s C I^ID e - so 

<CONTINUED) 


. 

JSR - - 

$CF3B 

;OUTPUT REGISTERS 

*33 

LDA-- 

$0353 

;GET BRK JUST HIT FLAG 

. 

EEQ 

*9 

;NOT SET 

m 

LDY- - 

$0,353 

GET BRK POINT OFFSET 

. 

LDAYY 

$0340 

;get low add of brk pt 

, 

STA- 

$19 



LDAYY 
ct« _ 

$03 4 D 

* t * 

• GET HIGH ADD OF BRK FT 

• 

w I n 




LDA# 

TAY 

$00 



STA5Y 

$13 

y RE-INSERT THE 1 00 ! BRK PT 

. 

STA-- 

$0333 

;CLEAR BRK JUST HIT FLAG 

*3 

LDX * - 

$LJ JL 

J CHECr. IF WATCH SET 


EEu 

v . 

;$03 = NOT SET 


cph# 

$04 

‘CHECK IF 14 A T C H !• IE MG R Y 


EEQ 

V 3 



CPXt» 

$03 

;CHECK IF WATCH WORD 

« 

CEO 

#2 



LDAXX 

$-033F 

* GET X 

*3 

CMP - - 

$03 3F 

; COMPARE TO INPUT WATCH VALUE 


BNE 

* 1 


*37 

LDA# 

$GE 

;WATCH FULFILLED MSG # 

, 

JSR - - 

$CF37 

; GL'TP U T i :E SSAGE 

. 

LDA# 

$14 


, 

JSR - - 

$CF37 



JMP-- 

•t. 13 

J FINISH 'JR ROUTINE 

*2 

LDA - - 

$0343 

;GET MEMORY LOCATION 


STP - 

$ 1 = 



LDP. - - 

$03 4A 



STA¬ 

$ 1A 



LES- - 

$033E 

• GET WATCH FLAG 


CMP# 

$05 

;CHECK IF WATCH WORD 

. 

EEQ 

$34 


, 

LDY# 

$30 


. 

LDA>Y 

$19 

)GET MEMORY VALUE 


JMP - - 

43 

;SO TO COMPARE 

t34 

LDY# 

$00 


+ 33 

LDA ) Y 

$13 



CMP YY 

$035A 


• 

BNE 

I NY 

* i 


• 

CRY# 

$32 



BNE 

*33 


. 

BEQ 

*37 


*1 

JSR-- 

$FFE4 

;GET CHARACTER FROM SYSTEM INPUT BUFFER 

m 

BEQ 

*4 


a 

CMP# 

$1 1 

)CSR DN - SLOWER 

m 

BNE 

* £ 1 


m 

LDA# 

$08 

;INCREMENT VALUE 

% 

ADC — 

$0354 

;ADD TO TIMER VALUE 


104 


> > > 

f=^ I 

I__ El » c MD e - s o 




<CONTINUED) 


JMP-- 

*35 


*21 

CMPtt 

58 1 

;CSR UP - FASTER 

. 

BNE 

*22 



LDA - - 

5D3D4 

;GET TIMER VALUE 


SBC# 

$03 

;DECREMENT VALUE 

*25 

3T'\- - 

50354 

JSTORE TIMER VALUE 

. 

JMP - - 

*4 


*22 

CMP# 

520 

; HOLD 


BNE 

* 10 


*5 

JSR- 

3FFE4 

;HOLD LOOP 

. 

220 

*5 


* 10 

cr IP It 

55 1 

;’Q 1 QUIT 


BNE 

*4 



JMP - - 

* 16 

;GO TO MAIN DRIVER LOOP 

*4 

LDA- 

525 

;GET CURRENT OPCODE VALUE 

*27 

LDX-- 

5034B 

;GET TRACE/EXECUTE FLAG 


BEQ 

*7 


. 

LDX- - 

50330 

;GET SUB SUFRESS FLAG 


BEQ 

*7 



CMP# 

520 

;TEST FOR 1 JSR 1 


cr-:E 

*6 



i r' - , c - - 

50357 

;INCREMENT SUBR LEVEL COUNTER 

. 

jnp-- 

*7 


■*s 

:mp# 

560 

;TEST FOR ’RTS 1 

• 

SHE 

*7 

;DECREMENT SUBR LEVEL 


DEC- - 

'30357 


BNE 

*7 



J SR — 

5CFSB 

;OUTPUT REGISTERS 

*7 

LDX-- 

•50356 

;GET TRACE CONTROL REGISTER 


BEG 

* 17 


* 15 

CPXM 

542 

j C CON'flNOUS TRACE 


BEQ 

*17 

; VALIDATE T'HE NEXT INSTRUCTION 


CFXH 

542 

;' B 1 CONTROLLED BREAK 


EEG 

* 17 



CPX# 

54A 

; ‘J 60 UNTIL JUMP 


BEC. 

*36 



JMP -- 

■ *13 

;GOTO ERROR ROUTINE 

*?G 

CMP# 

54C 

; 1 JMP--' OFCGDE 


BEG 

*23 

;STOP EXECUTION 


CMP# 

56C 

; 1 JMP <)' OPCODE 


BEQ 

*23 

;STOP EXECUTION 


ft MO# 

5 IF 

;MASK C TEST FOR BRANCH ) 


CMP# 

510 

fTEST FOR BRANCH 


BEQ 

*23 


*17 

LDA-- 

- 50357 

}GET SUB LEVEL 


BNE 

*25 


. 

LDA- 

- 5034B 

;GET TRACE/EXECUTE FLAG 


EEQ 

*25 


m 

LDA- 

- 50347 

;GET NEXT OPCODE 

. 

STA- 

5 IB 




ro co 

4.» fO 
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^jr- 3^“'* 

F=" I 

i_ e: s c md e - s 

<CONTINUED) 

LDA-- 

$0348 


STA- 

$1C 


LDXM 

$D9 

;SET OPCODE TABLE VECTORS 

STX- 

$19 


LDXM 

$C9 


S7X- 

$1A 


LDYM 

$00 


LDA > Y 

$19 

;GET TEST OPCODE FROM TABLE 

CMPM 

$02 

;END OF TABLE 7 

BEQ 

*24 

;-THEN INVALID OPCODE 

CMPM 

$FF 


SHE 

*29 


LOAM 

$8 1 

- — - — 

b: je 

*33 


CMP>Y 

$ 1E 

;COMPARE TO NEXT MEMONIC 

EEQ 

*25 

;VALID OPCODE! 

LDAtt 

$32 

/STEP THROUGH TABLE 

JSR - - 

$CF3D 

;ADD ACC TO INDEX 'A' 

Ji'P - - 

*26 


LDA — 

$3347 

;SET LOW BYTE OF NEXT OPCODE 

STn - - 

$0344 

;MOVE TO CURRENT HIGH OPCODE 

LCn- 

$0248 

} GET HIGH BYTE OF NEXT OPCODE 

3 T fi — 

$3345 

;MOVE TO CURRENT HIGH OPCODE 

LD fi- 

$0357 

;GET GUE LEVEL 

Bt IE 

*32 


LDh - - 

$0256 

;GET TRACE CONTROL REGISTER 

BNE 

*22 


LDA - - 

$0353 

;GET INSTRUCTION COUNTER 

3 ME 

*32 


JMF-- 

* 16 

GO TG MAIN DRIVER LOOP 

JMP - - 

$CF3S 

;GO TO TRACE DRIVER 

LDAM 

$15 

; M INVALID OPCODE" MSG M 

JSR - - 

$CF 3 7 


LDn- 

$1C 


J3R- * 

$CF76 



/*■ « n 


u. J* n - 

4 1C 


J3R- - 

4?CF76 


-v .. - 

*23 


LDAM 

$16 

;"JMP OR BRANCH DETECTED u MSG 

JSR - - 

$CF37 


LDA-- 

$0345 


JSR - - 

$C F 7 6 


LDP.— 

$0344 


JSR - - 

$CF76 


; JSR — 

$CFB8 


LDP — 

$0353 

;hide SUB FLAG 

BEG 

*33 


LDAM 

$00 


STA-- 

$0359 

;CLEAR HIDE SUB FLAG 

STA-- 

$033D 

;CLEAR SUB SUPPRESS FLAG 
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> > > i i_ e: = c md e - so < < < 

'(CONTINUED) 

*3S JMP-- SOFT 3 ;MAIN DRIVER LOOP 
* 13 LDA# S03 

STA — S033C 

JSR-- SCF3T ; ERROR CHECK - NO RTS 
JMR - -* SOFTS 
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RK 1 - 


< < < 


* *: * * * * * * * * * * 

; * * 

; *"BRK1.SO"* 

* * 

; * * * ******** 

2$SSA0 ********** BREAK POINT HANDLING ROUTINE ********** 

/ 

' BRK. vSOFTWARE INTERRUPT; ENTRY POIN'i 



EE I 

PL A 


;Y RE S 


G TP. - - 

$0040 



r^t 


;:: RED 


PL.- 

$33* : i 

i ACCUMULATOR 


S Tn — 

$6342 



PL.'-. 

V Tf , •• - 

$0 343 

; psu 


FLA 


>SHOULD BE PC Lull 


SEC 

SBCtt 

4-0 E 

;CORRECT 


STA-- 

$03 44 

i 3iuRE FC LOU 


PL A 

CDCrl 

$00 

;SHOULD BE PC HIGH 

!CORRECT 


2Tn ■ ■■ 

*0345 



rsy. 

ETA --- 

$03 43 

; TRANSFER STACK POINTER 

; STORE STACK POINTER 

<2 $3 6 

CS EM 

TRY FQINT 

WHEN '00 1 OFCOOE DETECTED 

r 

c r 

MSLE STEP 

ROUTINE. 


l_ r . -:, - - 

$035© 

;GET TRACE CONTROL FLAG 


CMP U 

$43 

; 1 D■ N BREAKS 


DEG 

* l 


fe-i 

LC-N# 

$13 



C T*;" 4 . • 

$03 

/SET CCLUMN 


LOA# 

$OB 

‘ MESSAGE it 


JER- - 

*CF3T 



Lcntf 

$07 



JER - - 

$CF37 

/MESSAGE 


LDA-- 

$0345 

;GET HIGH BYTE CF ADD 


JSR - - 

$C F 7 3 

;INT TO HEX OUT 


LDA — 

$0344 

;GET LOU BYTE OF AOD 


tc-*5 _ _ 

$CF73 



JER- -• 

$CFSB 

;DISPLAY REG ROUTINE 


CL I 

JMP-- 

$CF73 

;DRIVER LOOP 

>. 1 

DEC-- 

$0352 

;DECREMENT BRK COUNTER 

, 

BEG 

*4 





F=- X i— 


EZ a BIRK. 1 

XCONTINUED) 


S CZI 


LDA# $0 i 

STA— $0353 ;SI£T BRK JUST HIT FLAG 
LDY# $03 

LDA— $3344 ;G2T CURRENT LON ADD 
STA- $1S 

CMPYY $034E ;CHECK AGAINST BRK LOU 
EME t:3 

LDA - - £50345 ; GET CURRENT HIGH ADD 

STA- $ IA 

CMPYY $334D JCHECK AGAINST BRK HIGH 

BEG *5 

GEY 

3N£ t-3 .... — . 

i;Et. 4 

2TT— $0353 ;STORE OFFSET TO BRK PT 

LOS** $30 

LDAYY $&34F ;GET OPCODE VALUE 

STAX) $13 ;REPLACE *00' UITH OPCODE VALUE 

LDA — $3242 ; GET PS Li 

AND** $EF ; CLEAR BREAK FLAG 

STA-- $0243 

LDA-- $0343 * SCREEN DISPLAY MODE 


C' £. W! 

*6 


LDA - - 

$035 7 

; GET SUE LEVEL COUNTER 

3 me 

*2 


LDA** 

$EE 

; * + ' 

JS~ - - 

$FFD2 

; OUTPUT A CHARACTER 

— rr~ .. 

$D2 



JMF-- $CFS3 


* JUMP TO TRACE DRIVER 
INSTRUCTION EXECUTED WILL BE THE 
OPCODE UNDER THE BREAK POINT. 
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me: s s 


«=; i—i < < < 


; *********** 

: * * 

; *"MESS.SO”* 

* * 

; *********** 

THIS FILE CONTAINS ALL THE ASCII MESSAGES 

; GENERATED BY THE VARIOUS ROUTINES. 


©$CCS0 

A 


l 


A 

T 

A 

T 

A 

A 

T 

A 

i 

A 

T 

A 

T 

A 

A 

T 

A 

T 

A 

T 

A 

T 

A 

T 

A 

T 

A 

T 

A 


HEX ERROR 
$00 $00 - S 03 
COMMAND SYNTAX ERROR 
$0D $30 $03 
UNRECOGNIZED COMMAND 
$00 $00 $00 

CANNOT EXECUTE COMMAND 
$00 $00 $03 $03 

GK -02 DEBUGGER/TRACER 

$30 $0O 

VERSION 3.1 

$00 $30 

BREAK AT $ 

$30 

> 

$30 

OK 

$30 $30 

FC MEMGNIC 
$00 

ACC XR YR SP NV*BDIZC 
$0D $30 
BREAKPOINT 
$00 

SUBROUTINE SUPPRESSION 
$00 $00 
WATCH 
$03 
SET 

$SD $00 
(40T SET 
$0D $03 
SET AT $ 

$00 
FOR $ 

$03 

PC=$ 

$00 

COMPLETE 
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i i_ e; = me: s s 

•(CONTINUED) 


O 


T *0D *00 

A INVALID OPCODE AT * 

T *00 

A JMF CR ERANCH AT * 

T *0G 


;**:** MESSAGE LINK TABLE ***** 


T*CCG2 

*80 

*CC 

*8C 

*CC 

*A3 

*CC 

T 

*EA 

*cc 

*04 

*cc 

*EB 

*CC 

T 

*F3 

■*cc 

*03 

*CD 

*05 

*cc 

T 

*03 

*CD 

*13 

*CD 

*£F 

*CD 

T - 

T3C 

*CD 

*53 

*CD 

*5 A 

*CD 

T 

*63 

*30 

*6 A 

*CD 

*?4 

*CD 

T 

*72 

*CD 

*33 

*CD 

*3D 

*CD 

T 

*A i 

-5CD 








Ill 


> > 


j- «_i mr - re i—. 


; * * ********** 
! * * 
;*"JUMP.TBL"* 
; * * 
;* * * ** * ****** 


THIS FILE CONTAINS THE JUMP TABLE UTILIZED FOR 
LINKING TOGETHER THE VARIOUS PROGRAM SEGMENTS. 
ALSO CONTAINED IS THE HEX TABLE CODE USED FOR 
GUTPUTTINS HEX VALUE (IN ASCII) TO THE SCREEN. 


STOP 


0 * f. * -K 

:j. * * * *. * 

H E ; ■: I D E C IMA L CODE * r- * * * * * * 


012345S 

733ASCDEF 

3 * * * * 

COMMAND ROUTINE AND SUBROUTINE JUMP TABLE 

IMF - - 

£3000 

; PROGRAM START 

JMF - - 

£902 1 

J DEBUG MONITOR (MAIN DRIVER LOOP) 

JMF-- 

53433 

; INTERNAL TO ASCII HEX OUTPUT 

JMP - - 

£34 19 

; INTERNAL TO ASCII BINARY OUTPUT 

JMP - - 

£8430 


j f-.-'p.. _ 

£34 2D 

JINPUT FROM KEYS 

J? IF -• - 

£34 FO 

MEET SYSTEM FLAGS 

JMP 

£3590 

•H/4 CHAR ASCII TC INTERNAL 

JMP- - 

£3753 

JNMI SINGLE STEP ROUTINE (TRACE DR I 1 

JMP - - 

£3650 

J DISPLAY REGISTERS 

JMP - - 

£8 SC 2 

JERK EVALUATION DURING NMI 

JMP --- 

£34 EG 

jERROR/CANCEL RTS 

JMP - - 

£S42C 

; ERROR V NORMAL RTS 

J MP - - 

£8 4C 1 

MESSAGE OUTPUT 

JMP - - 

£S4B7 

; CLEAR BREAK SUBR ENTRY 

JMP • - 

£8330 

JADD TO ZP INDEX 'A* 

jyp _ _ 

£33 10 

;ADD TO ZF INDEX ‘B' 

JMP - - 

£3620 

;ADC TO ZP INDEX 'C* 

JMF - - 

£36 30 

JCOMPARE INDEX A TO B 

JMP 

*3000 

;SFARE 

J - ?F - - 

£9330 

;DISASSEMBLE ROUTINE 

J MP — 

£3030 

J TEMP 

JMP - - 

£3003 

; TEMP 

.JMP • - 

£3643 

JOUTPUT A SPACE 

JMP -- 

£8646 

JOUTPUT A <CR> 

JMP - - 

£3000 

;SPARE 

JMP - - 

£9000 

r SPARE 

JMP - - 

£3303 

JSPARE 

JMP-- 

£9000 

;SPARE 

JMF — 

£3000 

;SPARE 

J MP - - 

£3000 

;SPARE 

J MP — 

£90A0 

JOUTPUT UNRECOG. CMD 


** * * 


F=- x 


re 


> > 


j- i__i r-^11 
XCONTINUED) 


G$C37E ********** 1 CHARACTER CMD LINK TABLE ********** 
; USED BY THE COMMAND INTERPRETER TO LINK 

; TO THE PROPER COMMAND ROUTINES. 


A 

D 


T 

$E0 

$32 

A 

M 


T 

$20 

$9 1 

A 

F 


-r 

$90 

$92 


G 


T 

$ES 

$35 

A 

L 


T 

$33 

$90 

A 

5 


T 

$D 0 

$30 

A 

E 


T 

$E8 

$9S 

A 

T 


T 

$B 2 

$9S 

A 



T 

$43 

$94 

A 

P 


T 

$15 

$95 

T 

$00 



0$C9AE ********** £ CHARACTER CMD LINK TABLE ********** 
; SAME AS ABOVE EXCEPT FOR TWO CHARACTER COMMANDS. 

A B 


T 

$60 

$94 

A 

D 


T 

$10 

$94 

A 

S 


T 

$AA 

$96 

A 

C 


T 

$B0 

$9 4 

A 

L 


T 

$03 

$96 

A 

U 


T 

$02 

$96 

A 

E 


T 

$BS 

$96 

A 

T 


T 

$B2 

$96 

A 

H 


T 

$AA 

$91 

T 

$00 



APPENDIX C 
SAMPLE OUTPUT 


113 


114 




s _ s o c c 


; +. * ■* * * -it * * * * * * * * 


/ *■ 

; * 

■ ^ 

" SAMPLE' 

■>. 30 " * 

■it 


.>• -f’ 

*•* 

+c * * + * * * * * * * 


? 

■’"!-! IS FILE CONTAINS VARIOUS SAMPLE ROUTINES FROM 

a 

WHICH THE FOL! 

L 0 L’-i I f lG OUTPUT WA S U E NE RATED. 

2$8000 * * * * % * * * * S 

A MP L E M l * * * * * * * * * * 

/ 

TH 

IS SAMPLE 

IS USED FOR 

; 

- 

GENERAL S 

IN3LE STEPPING. 

; 

- 

WATCH MICROPROCESSOR REGISTER. 

; 

- 

WATCH MEMORY. 


LOAN 

■30 i 

; LOAD ACC WITH $01 


LOY# 

$03 

; LOAD Y-REG WITH $03 

r ! 

STY- 

- $6080 

/ STORE Y-REG AT $6000 

. 

-cc- 

•• $6000 

/ ADD VALUE AT $6000 ACC 

4 

DCY 


/ DECREMENT Y-REG 

. 

ONE 

* 1 

; IP NOT ZERO GOTO *1 


3RK 


; BREAK AND END ROUTINE 

•T 

2$808S 

•ft * ****** SAMPLE ME *#*f ****** 

T 

THIS SAMFLE 

Id USc.D FOR 

r 

- 

SINGLE STEPPING WITH A SUBROUTINE . 

r 

- 

SINGLE 3TE 

FPIMG WITH A SUBROUTINE AND THE 

J 


SUBROUTINE 

SUPPRESSION PARAMETER ACTIVE. 


LDA# 

$0 1 

/LOAD ADO WITH $01 


TAY 


* TRANSFER ACC TO Y-REG 

. 

STV- 

- $6000 

‘ STORE Y-REG AT $6000 

. 

LDH- 

$ 13 

/LOAD X-REG FROM ZERO PAGE $13 


LDY- 

■- $C0i0 

; LOAD Y-REG FROM $CG10 

. 

JSR- 

- $8040 

/JUMP TO SUBROUTINE AT $8040 

. 

TAY 


; TRANSFER ACC TO Y-REG 


I NX 


; INCREMENT X-REG 

. 

I NX 


; INCREMENT X-REG 

, 

STX- 

$600 1 

/ STORE X-REG AT $6001 

■ 

SRK 


/BREAK AND END ROUTINE 

r 

2' 

£8040 SAMPLE SUBROUTINE 

r 

STY- 

■- $S00 1 

/STORE Y-REG AT $6001 



>- > F=- I I_. EZ = S r-^1F=^ I—. El 

(CONTINUED) 

INY ;INCREMENT Y-REG 

TYA ;TRANSFER Y-REG TO ACC 

ADC# $3F ;ADD $2F TO ACC 

STft- - $S002 J STORE ACC AT $6002 

RTS ;RETURN TO CALLING PROGRAM 


CSS » ***..? ***.*» SAMPLE #3 ********** 

THIS SAMPLE IS USED FOR 
- S INGLE AND l^iULT IPLE EXECUTION OF 
CREAK POINTS. 


LOX* 

$00 

;LOAD X-REG WITH 

$00 

LDY# 

$FF 

;LOAD Y-REG WITH 

$FF 

inx 


;INCREMENT X-REG 


CEY 


;DECREMENT Y-REG 


JMF — 

*2 

.! JUMP TO *2 



>p 

BREAKPOINT #1 NOT SET 
BREAKPOINT #£ NOT SET 
SUBROUTINE SUPPRESSION NOT SET 
MATCH NOT SET 
>TC 


PC 

MEMONIC 

ACC 

XR 

YR 

SP 

NV*BDIZC 

3000 

LDAtt 

$0 1 

01 

00 

00 

F6 

00 100000 

3002 

LDY# 

$03 

31 

00 

03 

F6 

00 100000 

8004 

STY-- 

$803G 

01 

03 

03 

F6 

03 100000 

S307 

AOC-- 

$6000 

04 

33 

03 

FS 

30 100000 

300ft 

OEY 


04 

30 

02 

FS 

03 190300 

SC32 

bne 

$3034 

04 

CC 

02 

FS 

00 100000 

2GO 4 

STY-- 

$8000 

04 

00 

02 

FS 

30 100000 

-sec~ 

ACC- - 

$o 00 O 

03 

33 

02 

F 8 

30100000 

2 33 c 

CEY 


33 

00 

01 

F8 

00100000 

secs 

3NE 

$3304 

06 

00 

0 1 

F 8 

00100000 


3TY-- 

$8330 

OG 

00 

01 

Fo 

0010G030 

S0S7 

ACC - - 

$2330 

07 

33 

r% « 

O & 

F 8 

33103300 

SOCA 

CEY 


07 

OS 

00 

FG 

03100010 

S 00 ~ 

3NE 

$2001 

07 

00 

00 

FS 

00100010 




ACC 

XR 

YR 

SF 

NV*BO IZC 

BREAK 

AT $2 

033 

07 

00 

03 

F6 

00110010 


This exaple shows normal single stepping. It utilizes sample #1. 
The command issued was "Trace Continuously", TC. 



>p 

BREAKPOINT #1 NOT SET 
BREAKPOINT !*£ NOT SET 




SG'BROU 

MATCH 

TINE SUPPRESSION 

not SET 

NOT 

SET 

* T 0 1 

PC 

f IE MON IC ACC 

KR 

YR 

SP NV-r-BD izc 

8 GO 0 

LDA# 3?0i 0 1 

06 

01 

F7 00100000 

>T 02 

PC 

MEMGNIC ACC 

>:r 

YR 

SP NV*60IZC 

S 0 O 2 

urr* «J3 01 

06 

33 

P7 OGL000OC 

800:- 

3TY-~ i'SOGO Cl 

OS 

03 

P 7 03106800 


nr 

fiLMGfUC -CC 

vp 

Yrv 

SP NY*30133 

?0C7 

- CC • - 5b-. 30Co 04 

06 

03 

FT 30130000 


3 * * . C' h 

06 


'r . 00 1 3 O 0 0 0 

•t r- r 

E* iE. iwCc-i 04 

OS 

C k. 

t• 7 00 i OO0OO 

:t (>;• 

r r 

5 :Lir '.ON I C riUv_- 

XR 

YR 

SP NvfcoJlsC 

80 34 

"I": •• -iCCS S 04 

Co 


1 - / 30 l33oO0 

•- 7* r» -7 

: .3C- - ISC CO o£ 

06 

03 

FT 00100008 

•-s p 

0 E CS 

OS 


F 7 00*00000 

. • .. U. i: 

cm iicC't os 

06 

G 1 

P7 00*03000 


This example utilizes the same code as the previously 
sample. In this case, the commands "Trace 01", "Trace 02", 
"Trace 03", and "Trace 04" were issued. This caused single 
stepping of only the specified number of lines (specified in 
hexidecimal). 




BREAKPOINT #2 NOT SET 
SUBROUTINE SUPRES3ION NOT SET 
WATCH NOT SET 
>TC 


FC 

MEMONIC 

ACC 

XR 

YR 

SP 

NV*BD IZC 

8020 

LDA# 

$0 1 

G 1 

0 1 

E9 

F6 

00100000 

3CE2 

TAY 


01 

0 1 

01 

F6 

00100000 

8023 

STY-- 

$6000 

0 1 

0 1 

0 1 

F6 

00100008 

£328 

LDX- 

$19 

01 

FF 

Gl 

F6 

1013CG00 

G023 

LDY-- 

$ce 10 

3 1 

FF 

A3 

F6 

10100000 

S32E 

JSR - - 

$3040 

01 

FF 

A 9 

F 4 

10100000 

£050 

STY-- - 

4-600 : 

3 1 

FF 

A 3 

F4 

10100000 

-- 

:rrv 


0 i 

FF 

AA 

F4 

10100000 

C * i 

-"YA 


A A 

FF 

AA 

F4 

10100000 

33*53 

ADC# 

$3F 

E3 

FF 

AA 

F 4 

10103000 

£04~ 

STA-- 

$6002 

E3 

FF 

AA 

F 4 

10100000 

3 O ‘1A 

3T; 


E3 

FF 

AA 

F 6 

16100000 

302E 

TAY 


ES 

FF 

E3 

F £ 

10100880 

302F 

I NX 


E3 

30 

E3 

F o 

00100013 

8320 

I NX 


E3 

0 1 

E3 

F6 

30160300 

S33 1 

st>: - -• 

$600 1 

23 

0 1 

E3 

F6 

36 100330 




ACC. 

XR 

YR 

3F 

NV*BDIZC 

•PEAK 

AT $S 

034 

23 

0 1 

23 

F6 

331 10306 


BREAKPCINT #1 NOT SET 
EPEAKPGINT r-c. NOT SET 

- '.JCRCL'T I NE 3 P R E 3 S IC N 3 E T 

HATCH NOT SET 


MEMONIC AGO XR YR Sr NV 


10 

10 

10 

10 

10 


6020 

LDA# 

$01 

Gl 

01 

23 

F 6 

£022 

TAY 


0 1 

0 1 

0 1 

F 6 

3023 

STY - - 

$6000 

0 1 

01 

3 1 

i-S 

3026 

LDX- 

$13 

0 1 

F r 

0 1 

r 6 

*~ F 

LDY-- 

$C0 16 

£: 

FT 

A3 

Fb 

ce 

.rep _ - 

4B04C 

0 i 

FF 

AS 

F 4 




E3 

FF 

A A 

FB 


-r.^V 


E9 

FF 

E3 

F6 

302F 

i I ’ • 


E3 

36 

23 

F6 


I NX 


E9 

01 

23 

r 6 

£03 1 

3 . 

$600 1 

E3 

0 1 

ES 

F 6 




ACC 

XR 

YR 

SP 

CREAK. 

A T $£ 

034 

E3 

G 1 

E3 

F 6 


*BOlZC 
100000 
1 60030 
100000 
100000 
100000 
100000 
160000 
100000 
1 000 10 
100000 
1100000 
'♦EOIZC 
) 110000 


The above examples show normal execution of a subroutine 
and execution of a subroutine with the "Subroutine Suppression" 
parameter active. As seen, at address $802B (top example) a sub¬ 
routine is entered. The subroutine is exitted at address $802E. 
The bottem example shows that the subroutine is not displayed when 
"subroutine Suppression is active. Only the first line of it (the 
JSR call itself) and the register values upon RTS. These examples 
utilize sample #2. 




>p 

BREAKPOINT #1 NOT SET 


BREAKPOINT 

#2 NOT 

SET 





SUBROUTINE 

SUPRE33 

ION 

NOT 

‘ SET 


WATCH 

Y FOR 

£01 






>TC 








PC 

MEMONIC 

ACC 

XR 

YR 

SP 

NV*BDIZC 

3000 

LDA# 

£0 1 

0 1 

00 

30 

FE 

00100000 

3002 

LDYS 

£03 

01 

00 

03 

FE 

00 100000 

8004 

STY - - 

$6000 

01 

00 

03 

FE 

00100000 

3307 

ADC — 

£3003 

04 

00 

83 

FE 

03100300 

8 30 A 

DEY 


04 

00 

08 

FE 

00100000 

80CD 

BNE 

£3004 

0-> 

00 

02 

FE 

00103000 

3 3 3 4 

STY-- 

£8 ?tj- 

34 

00 

02 

FE 

00100000 

SCOT 

ADC — 

£3330 

03 

00 

02 

FE 

00100000 

COCA 

02 


08 

00 

31 

FE 

30 103300 

WATCH 

CCMP 

LETS 







This example shows the watch command. It utilizes sample 
#1. The watch parameter has been set to "Watch Y-reg for $01". 

Upon issuance of the "Trace continuously" command, execution starts. 
Execution is halted when the Y-reg attains the value $01. 



BREAKPOINT #i NOT SET 
BREAKPOINT #2 NOT SET 
SUBROUTINE SUPRESS ION NOT SET 


HATCH 

>TC 

X FOR 

*05 






PC 

MEMONIC 

ACC 

XR 

YR 

SP 

NV*BO IZC 

S060 

LDXtt 

*00 

00 

00 

FF 

F6 

0110001 1 

9062 

LDY# 

*FF 

00 

00 

FF 

F6 

1 1 13000 1 

SQ64 

I NX 


00 

31 

FF 

F6 

01 100001 

2065 

DEY 


00 

01 

FE 

F6 

1 1 10000 1 

cOSS 

JMP - - 

*£064 

00 

01 

FE 

F6 

1 1 100001 

2064 

INK 


00 

02 

FE 

F6 

01100001 

3G65 

DEY 


03 

02 

FD 

F6 

1 1 100001 

BOSS 

JMP-- 

*6064 

00 

02 

FO 

F6 

1 1 10000 1 

3064 

INX 


00 

03 

FD 

F6 

01100001 

2025 

DEY 


00 

03 

FC 

F6 

1 1 100001 

3066 

JMP - - 

*3064 

00 

32 

FC 

F6 

1 1 100001 

2064 

INX 


00 

04 

FC 

F6 

0 1 10000 1 

3065 

DEY 


00 

04 

FB 

F6 

1 1 1O0001 

8066 

JMP - - 

*8064 

00 

04 

FB 

F6 

1 1 10800 1 

3064 

WATCH 

INX 

COMPLETE 

00 

05 

FB 

F6 

0 1 13G00 1 


> 

This example show the watch command utilizing sample #3. 

The parameter "Watch X-reg for $05" was issued. The "Trace 
continuously" command begins execution. When the X-register attains 
the value $05, execution is halted. 



BREAKPOINT #1 NOT SET 
BREAKPOINT #2 NOT SET 


SUBROUTINE 

SUPRESS 

ION 

NOT 

’ SET 


WATCH 

$6000 

FOR $03 





>TC 








PC 

MEMONIC 

ACC 

XR 

YR 

SP 

NV*BD IZC 

8000 

LDA# 

$ei 

01 

05 

FB 

F6 

01100001 

8002 

LDY# 

$03 

0 1 

05 

03 

F6 

61 100001 

£004 

STY— 

$£000 

01 

05 

03 

F6 

0 1 100001 


WF~CH COMPLETE 


This is another example of the watch command utilizing 
sample #1. The parameter "Watch memory address $6000 for $03" 
was issued. Again the "Trace continuously" command was issued. 

When the value at address $6000 contained $03, execution was halted. 
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BREAKPOINT 31 SET AT $3065 
BREAKPOINT r2 NOT SET 
SUBROUTINE SUPRESSION NOT SET 
HATCH NOT SET 
>TC 


PC 

MEMONIC 

ACC 

XR 

YR 

SP 

NV*BD IZC 

3060 

LDX# 

$00 

06 

0G 

FC 

F7 

33 100G10 

£062 

LDY# 

$FF 

06 

00 

FF 

F7 

13100000 

8064 

INK 


G6 

61 

FF 

F7 

00100000 




ACC 

XR 

YR 

SP 

NV*BDIZC 

BPEAK 

AT $S3S5 


0 1 

FF 

F7 

30 1 13003 


BREAKPOI NT 

»i SET 

AT 

$53 

S3 



breakpoint 

42 rlC" 

SET 





CLTROLTI. ;r 

. j U_ 

L* • 'w! « 

iJu 

'i 3: 

CT 


*V"C:+ iu-r 

52 7 






"6 £ - 







■?r ; *- 

11! C 

ACC 

! .R 

. :5 

Sr 

• 1 '• i C o 

IZdZ _LXt* 


Cc 

CC 

FC 

c . 

*■—3 .LiijJ .3 

C3SE Lu I 7: 

j-rv 

36 

63 

F F 

F7 

16 1 LUUoO 

-f.-'O'-i •. i\. : . 


■Jo 

3 i. 

FF 

F V 

3k. 1 -aOCeQ 

* S C Z C E 


66 

b i 

r E 

FT 

i 6.03033 

.*• ~ *T J J * C .. .. 

$3054 

JO 

0 1 

FE 

F7 

1 3 103000 

7 7 7, : r 1 i i' •! 


06 

•-> 01 

r £ 

F 7 

33 133303 

’ * n . 


-'•o- 

Jil 

FD 

F7 

1 C :C'OJ 0 U 

ccc: JMT - - 

$3C3-; 

0 5 


r J 

i • i 

i 3 i 0300o 

- - * •• • 


- 

- 


.. 

• -V - 

— - - a. 1 • 


--j 

W-- 

r u 

• 

. !_• l_* O 0 W 

"ce*" esc 


33 


.'-w. 

r 7 

. j. o 0 3 3 0 

c?:c *■ t - 

iCo ; 

C - 


F 5 

l - * 

x - 503oil 

ccc • i’ \y. 


05 

U-i 

r C 

7 

3 U 1 00500 



r. 

.ii\ 

iR 

Sr 

U'« ILU i 1 0 

cczrc vr $s, 

55 3 

uo 

w* -i 

«- *—• 

f 7 

33 1 13603 


Utilizing sample #3, the above examples show both normal 
break points and the multiple detection of break points. In both 
examples, the break point is set at $8065 (break point #1). In 
the top case, when address $8065 is reached, the break point is 
activated. In the lower case, the command "Trace until Break $04" 
was issued. In this case, the break point is executed through 
itself three times (indicated by the "+'"s on the output) before 
finally halting execution on the fourth detection. 



BREAKPOINT *1 SET AT $8064 
BREAKPOINT #2 SET AT $8065 
SUBROUTINE’SUPRESSION NOT SET 
WATCH NOT SET 
>TB OA 


PC 

ME MON IC 

ACC 

XR 

YR 

SP 

NV*BDIZC 

8060 

LDX# 

$00 

01 

00 

F6 

F6 

0 1 1000 11 

8062 

LOT# 

$FF 

0 1 

00 

FF 

F6 

1 1 10000 1 

-‘■3064 

I NX 


01 

0 1 

FF 

F6 

3 l 10000 1 

+ 9065 

DEY 


0 1 

e i 

FE 

F6 

11 10000 1 

3066 

JMP - - 

$8064 

0 1 

01 

FE 

F6 

1 1 13G00 1 

+ 308 4 

I NX 


0 1 

02 

FE 

F6 

01 100001 

+ 8065 

DEY 


o 1 

32 

FD 

F6 

1 1 133001 

3068 

JMP - - 

$8064 

0 1 

02 

FD 

F6 

1 1 10300 1 

+806 £ 

I NX 


01 

03 

FO 

F6 

01 133001 

+ 3 365 

□EY 


0 1 

03 

FC 

F6 

1 1 10000 1 

8066 

JMP - - 

$3064 

o: 

03 

FC 

F6 

1 1 130001 

+ 3064 

I NX 


0i 

04 

r C 

F6 

0 1 10000 1 

+3065 

DEY 


Gi 

04 

FB 

F6 

1 1 100001 

3033 

JMP - - 

$8064 

0 1 

04 

FE 

F6 

1 1 100001 

+3GS4 

I NX 


01 

05 

FB 

F6 

0 1 100001 




ACC 

XR 

YR 

SP 

NV*BDIZC 

BREAK 

AT $3065 

0 1 

05 

FB 

F6 

01 1 10001 


The above example, utilizing sample #3, shows two break 
points set. One is set at $8064, and one at $8065. The command 
"Trace until Break $0A" was issued. As seen, the two break points 
were encountered nine times. One the tenth detection, execution 
was halted. 
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